IMSAdminBase::SetLastChangeTime

The IMSAdminBase::SetLastChangeTime method sets the last change time associated with a key in the metabase.

HRESULT SetLastChangeTime(
  METADATA_HANDLE hMDHandle,     //handle to the metabase
  LPCWSTR pszMDPath,             //path to the key, relative to 
                                 // hMDHandle
  PFILETIME pftMDLastChangeTime  //pointer to 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 the path of the key to be set, 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 contains the last change time to set for the key
bLocalTime
Specifies whether the value pointed at by 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

In addition to calls to this method, last change times are updated whenever data or subkeys are set, added, renamed, deleted, copied, or moved.