IMSAdminBase::GetHandleInfo

  • Article

The IMSAdminBase::GetHandleInfo method retrieves information associated with the specified metabase handle.

HRESULT GetHandleInfo(
      METADATA_HANDLE hMDHandle,
      PMETADATA_HANDLE_INFO pmdhiInfo
);

Parameters

  • hMDHandle
    Specifies a handle to the metabase, either METADATA_MASTER_ROOT_HANDLE or a handle returned by a previous call to the IMSAdminBase::OpenKey method.

  • pmdhiInfo
    Points to a METADATA_HANDLE_INFO structure that receives the information about the handle.

Return Values

Returns an HRESULT that contains one of the following values:

Value

Description

E_HANDLE

The handle is invalid.

S_OK

The method succeeded.

Remarks

The dwMDSystemChangeNumber member of the METADATA_HANDLE_INFO structure pointed to by pmdhiInfo will correspond to the system change number generated at the time the handle was created. It will not change if write operations are performed by using this handle, or any other handle. You can compare this number with the value returned by the IMSAdminBase::GetSystemChangeNumber method to see if any write operations have been performed since the handle was opened.

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.