Export (0) Print
Expand All

IBindCtx::GetRunningObjectTable method

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

pprot [out]

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

Minimum supported client

Windows 2000 Professional [desktop apps | Windows Store apps]

Minimum supported server

Windows 2000 Server [desktop apps | Windows Store apps]

Header

ObjIdl.h

IDL

ObjIdl.idl

IID

IID_IBindCtx is defined as 0000000e-0000-0000-C000-000000000046

See also

IBindCtx
IMoniker
IRunningObjectTable

 

 

Community Additions

ADD
Show:
© 2014 Microsoft