IRunningObjectTable interface (objidl.h)

Manages access to the running object table (ROT), a globally accessible look-up table on each workstation. A workstation's ROT keeps track of those objects that can be identified by a moniker and that are currently running on the workstation. When a client tries to bind a moniker to an object, the moniker checks the ROT to see if the object is already running; this allows the moniker to bind to the current instance instead of loading a new one.

Inheritance

The IRunningObjectTable interface inherits from the IUnknown interface. IRunningObjectTable also has these types of members:

Methods

The IRunningObjectTable interface has these methods.

 
IRunningObjectTable::EnumRunning

Creates and returns a pointer to an enumerator that can list the monikers of all the objects currently registered in the running object table (ROT).
IRunningObjectTable::GetObject

Determines whether the object identified by the specified moniker is running, and if it is, retrieves a pointer to that object.
IRunningObjectTable::GetTimeOfLastChange

Retrieves the time that an object was last modified.
IRunningObjectTable::IsRunning

Determines whether the object identified by the specified moniker is currently running.
IRunningObjectTable::NoteChangeTime

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.
IRunningObjectTable::Register

Registers an object and its identifying moniker in the running object table (ROT).
IRunningObjectTable::Revoke

Removes an entry from the running object table (ROT) that was previously registered by a call to IRunningObjectTable::Register.

Remarks

The ROT contains entries of the following form: (pmkObjectName, pUnkObject).

The pmkObjectName element is a pointer to the moniker that identifies the running object. The pUnkObject element is a pointer to the running object itself. During the binding process, monikers consult the pmkObjectName entries in the ROT to see whether an object is already running.

Objects that can be named by monikers must be registered with the ROT when they are loaded and their registration must be revoked when they are no longer running.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps | UWP apps]
Minimum supported server Windows 2000 Server [desktop apps | UWP apps]
Target Platform Windows
Header objidl.h

See also

GetRunningObjectTable

IBindCtx::GetRunningObjectTable

IROTData