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.
| DWORD dwRegister,
||//Value identifying registration being updated
| FILETIME *pfiletime
||//Time containing object's last change time
[in] Specifies a value identifying the ROT entry of the changed object. This
value was previously returned by IRunningObjectTable::Register
[in] Points to a FILETIME
structure containing the object's last change time.
Indicates that the change time was recorded successfully.
Indicates that dwRegister
is not a valid ROT entry or pfiletime
is an invalid pointer.
The time recorded by this method can be retrieved by calling IRunningObjectTable::GetTimeOfLastChange
This method is provided to enable a program to check whether a connection
between two objects (represented by one object holding a moniker that identifies
the other) is up-to-date. For example, if one object is holding cached
information about the other object, this method can be used to check whether the object
has been modified since the cache was last updated. See IMoniker::GetTimeOfLastChange
Notes to Callers
If you're a moniker provider (that is, you hand out monikers identifying your
objects to make them accessible to others), you must call the IRunningObjectTable::NoteChangeTime
method whenever your objects are modified. You must have previously called IRunningObjectTable::Register
and stored the identifier returned by that method; you use that identifier
when calling IRunningObjectTable::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.
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages