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.
HRESULT GetRunningObjectTable( [out] IRunningObjectTable **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.
This method can return the standard return values E_OUTOFMEMORY, E_UNEXPECTED, and S_OK.
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.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.
|Minimum supported client||Windows 2000 Professional [desktop apps | UWP apps]|
|Minimum supported server||Windows 2000 Server [desktop apps | UWP apps]|