IBindCtx::GetRunningObjectTable  JUMX9D

Provides an interface pointer to the Running Object Table (ROT) for the machine on which this bind context is running.

HRESULT GetRunningObjectTable(

Parameter

pprot

[out] When successful, indirect pointer to the IRunningObjectTable2.JI.X5 interface on the Running Object Table. If an error occurs, *pprot is set to NULL. If *pprot is non-NULL, the implementation calls IUnknown::AddRef1SHW0SS on the parameter; it is the caller s responsibility to call IUnknown::ReleaseDUW01A.

Return Values

This method supports the standard return values E_OUTOFMEMORY and E_UNEXPECTED, as well as the following:

S_OK

A pointer to the ROT was returned successfully.

Remarks

The Running Object Table is a globally accessible table on each machine. It keeps track of all the objects that are currently running on the machine.

Notes to Callers

Typically, those implementing a new moniker class (through an implementation of IMoniker18XK102 interface) call IBindCtx::GetRunningObjectTable. It is useful to call this method in an implementation of IMoniker::BindToObject486P_PV or IMoniker::IsRunning1CR3B7K to check whether a given object is currently running. You can also call this method in the implementation of IMoniker::GetTimeOfLastChange123HWA2 to learn when a running object was last modified.

Moniker implementations should call this method instead of using the GetRunningObjectTable4LY6_QB function. This makes it possible for future implementations of IBindCtx1JJ0LSF to modify binding behavior.

See Also