GetRunningObjectTable

Returns an IRunningObjectTable pointer to the local Running Object Table (ROT).

HRESULT GetRunningObjectTable(

DWORD reserved,	//Reserved
LPRUNNINGOBJECTTABLE *pprot	//Receives an IRunningObjectTable pointer
);

Parameters

reserved

Indicates reserved for future use.

pprot

Receives an IRunningObjectTable interface pointer to the local ROT. If an error occurs, *pprot is undefined; otherwise, the caller is responsible for calling IUnknown::Release on the parameter.

Return Values

S_OK

Indicates that an IRunningObjectTable pointer was successfully returned.

E_UNEXPECTED

Indicates an unexpected error.

Comments

Each workstation has a local ROT that maintains a table of the objects that have been registered as running on that machine. This function returns an IRunningObjectTable interface pointer, which provides access to that table.

Moniker providers, which hand out monikers identifying objects to make them accessible to others, should call GetRunningObjectTable. Use the interface pointer returned by this function to register your objects when they begin running, to record the times that those objects are modified, and to revoke their registrations when they stop running. See the IRunningObjectTable interface for more information.

The most common types of moniker provider are compound-document link sources. This includes server applications that support linking to their documents (or portions of a document) and container applications that support linking to embeddings within their documents. Server applications that do not support linking can also use the ROT to cooperate with container applications that support linking to embeddings.

If you're writing your own moniker class (implementing the IMoniker interface) and you need an interface pointer to the ROT, use the IBindCtx::GetRunningObjectTable method rather than the GetRunningObjectTable function. This allows future implementations of the IBindCtx interface to modify binding behavior.

See Also

IBindCtx::GetRunningObjectTable, IMoniker, IRunningObjectTable

Software for developers

Delphi Components
.Net Components
Software for Android Developers

More information resources

MegaDetailed.Net
Unix Manual Pages
Delphi Examples

Databases for Amazon shops developers

Amazon Categories Database
Browse Nodes Database