IMSAdminBase::GetLastChangeTime

The IMSAdminBase::GetLastChangeTime method retrieves the last change time associated with a key.

HRESULT GetLastChangeTime(
      METADATA_HANDLE hMDHandle,
      LPCWSTR pszMDPath,
      PFILETIME pftMDLastChangeTime,
      BOOL bLocalTime
);

Parameters

  • hMDHandle
    Specifies a handle to the metabase. This can either be METADATA_MASTER_ROOT_HANDLE or a handle with write permissions returned by the IMSAdminBase::OpenKey method.

  • pszMDPath
    Specifies a string that contains the path of the affected key, 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.

  • pftMDLastChangeTime
    Points to a FILETIME structure that receives the time of the last change.

  • bLocalTime
    Specifies whether the value returned in pftMDLastChangeTime is local (TRUE), or UTC time (FALSE)

Return Values

Returns an HRESULT that contains one of the following values:

Value

Description

E_INVALIDARG

The parameter is incorrect.

HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)

The specified path is not found.

S_OK

The method succeeded.

Remarks

Last change times are updated whenever data or subkeys are set, added, renamed, deleted, copied, or moved.

Last change times are not updated when this method is called.

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.