IMSAdminBase::SetData

The IMSAdminBase::SetData method sets a data item. If data with that identifier does not already exist, this method creates and inserts a data item into the list of data items of that type. If data with that identifier already exists, this method sets the new data value. Duplicate data identifers are not allowed even if the entries are of different user types or data types.

HRESULT SetData(
  METADATA_HANDLE hMDHandle,   //metadata handle
  LPCWSTR pszMDPath,           //path of the key relative to 
                               // hMDHandle
  PMETADATA_RECORD pmdrMDData  //pointer to data
); 
 

Parameters

hMDHandle

Specifies a handle with write permissions as returned by the IMSAdminBase::OpenKey method. METADATA_MASTER_ROOT_HANDLE is not valid for this operation.

pszMDPath

Specifies a string that contains the path of the key that receives the entry, 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 /W3SVC.

pmdrMDData

Points to a METADATA_RECORD structure that contains the data to set. All the structure members must be filled except dwMDDataTag.

Return Values

Returns an HRESULT that contains one of the following values:

© 1997 by Microsoft Corporation. All rights reserved.

Comments:

  .