IMSAdminBase::SetLastChangeTime

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

HRESULT SetLastChangeTime(
      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 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 by 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
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

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

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.