IMSAdminBase::GetDataSetNumber

  • Article

The IMSAdminBase::GetDataSetNumber method retrieves all the data set numbers associated with a key in the metabase. A data set number is a unique number identifying the data items at that key, including inherited data items. Keys with the same data set number have identical data.

HRESULT GetDataSetNumber(
      METADATA_HANDLE hMDHandle,
      LPCWSTR pszMDPath,
      DWORD* pdwMDDataSetNumber
);

Parameters

  • hMDHandle
    Specifies a handle to the metabase, either METADATA_MASTER_ROOT_HANDLE or a handle with read permission returned by the IMSAdminBase::OpenKey method.

  • pszMDPath
    Points to a string that contains the path of the key to have its data set number retrieved, relative to the path of hMDHandle. For example, if the handle references the /LM key, you could specify the Web services subkey by using the path /W3SVC.

  • pdwMDDataSetNumber
    Points to a DWORD that receives the number associated with this data set. You can use this value to identify data sets common to multiple keys.

Return Values

Returns an HRESULT that contains one of the following values:

Value

Description

E_INVALIDARG

The parameter is incorrect.

S_OK

The method succeeded.

Requirements

Client: Requires Windows XP Professional, Windows 2000 Professional, or Windows NT Workstation 4.0.

Server: Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.

Product: IIS

Header: Declared in iadmw.h; include iiscnfg.h.