IMSAdminBase::GetLastChangeTime

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

HRESULT GetLastChangeTime(
  METADATA_HANDLE hMDHandle,     //metabase handle.
  LPCWSTR pszMDPath,             //path to the key, relative to 
                                 // hMDHandle
  PFILETIME pftMDLastChangeTime  //receives the last change time
  BOOL bLocalTime                //local or UTC time
);

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 using the path /W3SVC.
pftMDLastChangeTime: Points to a FILETIME structure that receives the last change time.
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
ERROR_INVALID_PARAMETER	The parameter is incorrect.
ERROR_PATH_NOT_FOUND	The specified path is not found.
ERROR_SUCCESS	The method succeeded.

Remarks

Last change times are updated whenever data or subkeys are set, added, renamed, deleted, copied, or moved, or when this method is called.