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 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
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.