IRunningObjectTable::NoteChangeTime method

Records the time that a running object was last modified. The object must have previously been registered with the running object table (ROT). This method stores the time of last change in the ROT.

Syntax


HRESULT NoteChangeTime(
  [in] DWORD    dwRegister,
  [in] FILETIME *pfiletime
);

Parameters

dwRegister [in]

The identifier of the ROT entry of the changed object. This value was previously returned by IRunningObjectTable::Register.

pfiletime [in]

A pointer to a FILETIME structure containing the object's last change time.

Return value

This method can return the standard return values E_INVALIDARG and S_OK.

Remarks

The time recorded by this method can be retrieved by calling IRunningObjectTable::GetTimeOfLastChange.

Notes to Callers

A moniker provider (hands out monikers identifying its objects to make them accessible to others) must call the NoteChangeTime method whenever its objects are modified. It must have previously called IRunningObjectTable::Register and stored the identifier returned by that method; it uses that identifier when calling NoteChangeTime.

The most common type of moniker provider is a compound-document link source. This includes server applications that support linking to their documents (or portions of a document) and container applications that support linking to embeddings within their documents. Server applications that do not support linking can also use the ROT to cooperate with container applications that support linking to embeddings.

When an object is first registered in the ROT, the ROT records its last change time as the value returned by calling IMoniker::GetTimeOfLastChange on the moniker being registered.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

ObjIdl.h

IDL

ObjIdl.idl

IID

IID_IRunningObjectTable is defined as 00000010-0000-0000-C000-000000000046

See also

IMoniker::GetTimeOfLastChange
IRunningObjectTable

 

 

Show: