IHlinkBrowseContext::GetObject

Retrieves an object previously registered in the browse context. If the object referred to by pimk is not registered in the browse context, then IHlinkBrowseContext::GetObject binds to the full moniker and retrieves the object if the following conditions are met: 1) fBindlfRootRegistered is set to TRUE; 2) the moniker is referring to an embedded object (the moniker pimk is a generic composite moniker); and, 3) the root object of the containment hierarchy is registered with the browse context.

HRESULT GetObject(

IMoniker * pimk,

// Moniker interface pointer of the object being retrieved

BOOL fBindIfRootRegistered

// Determines binding to the moniker and retrieval of the object

IUnknown ** ppiunk

// Location to receive the unknown interface pointer of requested object

);

Parameters

pimk: [in,unique] Identifies the object being retrieved.
fBindIfRootRegistered: [in] If set to TRUE, IHlinkBrowseContext::GetObject binds to the moniker and retrieves the object (if the object referred to by pimk is not registered in the browse context).
ppiunk: [out] Indirect pointer to the IUnknown interface of the object being retrieved.

Return Values

S_OK: Indicates the previously registered object has been retrieved.
S_FALSE: Indicates no object indicated by pmk was registered in the browse context.

See Also

IHlinkBrowseContext::Register

IMoniker * pimk,	// Moniker interface pointer of the object being retrieved
BOOL fBindIfRootRegistered	// Determines binding to the moniker and retrieval of the object
IUnknown ** ppiunk	// Location to receive the unknown interface pointer of requested object
);