IBindCtx::GetRunningObjectTable method (objidl.h)
Retrieves an interface pointer to the running object table (ROT) for the computer on which this bind context is running.
Syntax
HRESULT GetRunningObjectTable(
[out] IRunningObjectTable **pprot
);
Parameters
[out] pprot
The address of a IRunningObjectTable* pointer variable that receives the interface pointer to the running object table. If an error occurs, *pprot is set to NULL. If *pprot is non-NULL, the implementation calls AddRef on the running table object; it is the caller's responsibility to call Release.
Return value
This method can return the standard return values E_OUTOFMEMORY, E_UNEXPECTED, and S_OK.
Remarks
The running object table is a globally accessible table on each computer. It keeps track of all the objects that are currently running on the computer.
Notes to Callers
Typically, those implementing a new moniker class (through an implementation of IMoniker interface) call GetRunningObjectTable. It is useful to call this method in an implementation of IMoniker::BindToObject or IMoniker::IsRunning to check whether an object is currently running. You can also call this method in the implementation of IMoniker::GetTimeOfLastChange to learn when a running object was last modified.Moniker implementations should call this method instead of using the GetRunningObjectTable function. This makes it possible for future implementations of IBindCtx to modify binding behavior.
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 |