IMSAdminBase::AddKey

The IMSAdminBase::AddKey method creates a key and adds it to the metabase as a subkey of an existing key at the specified path.

HRESULT AddKey(

  METADATA_HANDLE hMDHandle, //metabase handle.

  LPCWSTR pszMDPath    //path to the key relative to hMDHandle.

);

 

Parameters
hMDHandle
Specifies a handle with write permissions as returned by the IMSAdminBase::OpenKey method. The value METADATA_MASTER_ROOT_HANDLE is not valid for this operation.
pszMDPath
Points to a string that contains the new key's path, relative to the path of hMDHandle. For example, if the handle references the /LM key, you could specify the Web services subkey using the path /LM/W3SVC.

This parameter cannot be null.

Return Values

Returns an HRESULT that contains one of the following values:

Value Description
ERROR_ACCESS_DENIED Access is denied. Either the open handle does not have read or write permission as needed, or the user does not have sufficient permissions to perform the operation.
ERROR_DUP_NAME A key of that name already exists in the metabase.
ERROR_INVALID_NAME The specified name is invalid.
ERROR_INVALID_PARAMETER The parameter is incorrect.
ERROR_NOT_ENOUGH_MEMORY Not enough storage is available to process this command.
ERROR_PATH_NOT_FOUND The specified path is not found in the metabase.
ERROR_SUCCESS The method succeeded.