Share via

IMSAdminBase::SetLastChangeTime

  • Article

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.