IBindCtx::GetRunningObjectTable

Windows Mobile 6.5
A version of this page is also available for
4/8/2010

This method provides an interface pointer to the Running Object Table for the computer on which this bind context is running.

The IBindCtx::GetRunningObjectTable method is supported in DCOM, but it is not supported in COM.

Calling this method in COM returns a value of E_NOTIMPL.


HRESULT GetRunningObjectTable(
  IRunningObjectTable** pprot
);

pprot

[out] Address of the 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 the IUnknown::AddRef method on the running table object.

It is the caller's responsibility to call the IUnknown::Release method.

The following table shows the return values for this method.

Value Description

E_OUTOFMEMORY

A standard return value.

CO_E_NOTINITIALIZED

CoInitialize was not called.

E_NOTIMPL

This method is not implemented.

S_OK

A pointer to the Running Object Table was returned successfully.

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.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Notes to Callers

Typically, those implementing a new moniker class (through an implementation of IMoniker interface) call IBindCtx::GetRunningObjectTable.

It is useful to call this method in an implementation of the IMoniker::BindToObject or IMoniker::IsRunning method to check whether a given object is currently running.

You can also call this method in the implementation of the IMoniker::GetTimeOfLastChange method 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 the IBindCtx interface to modify binding behavior.

Headerobjidl.h, objidl.idl
Libraryole32.lib, uuid.lib
Windows Embedded CEWindows CE 2.0 and later
Windows MobileWindows Mobile Version 5.0 and later

Community Additions

Show: