IRunningObjectTable::GetObject

HRESULT IRunningObjectTable::GetObject(pmkObjectName, ppunkObject)

If the object designated by pmkObject name is registered as actually running, then return the object so registered. The R.O.T. compares monikers by sending IMoniker::IsEqual to the monikers already in the table with moniker on the right as an argument.

This is the function moniker implementations should use to test if they are already running (and get the pointer to the object if so).

Argument

Type

Description

pmkObjectName

IMoniker*

The moniker in whom interest is being expressed.

ppunkObject

IUnknown**

The place to return the pointer to the object. A returned value of NULL indicates that the object is not registered.

return value

HRESULT

S_OK, MK_E_UNAVAILABLE