Returns an IRunningObjectTable
pointer to the local Running Object Table (ROT).
| DWORD reserved,
| LPRUNNINGOBJECTTABLE *pprot
||//Receives an IRunningObjectTable pointer
Indicates reserved for future use.
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.
Indicates that an IRunningObjectTable
pointer was successfully returned.
Indicates an unexpected error.
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.
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages