IBindCtx::GetObjectParam method (objidl.h)
Retrieves an interface pointer to the object associated with the specified key in the bind context's string-keyed table of pointers.
HRESULT GetObjectParam( [in] LPOLESTR pszKey, [out] IUnknown **ppunk );
The bind context string key to be searched for. Key string comparison is case-sensitive.
The address of an IUnknown* pointer variable that receives the interface pointer to the object associated with pszKey. When successful, the implementation calls AddRef on *ppunk. It is the caller's responsibility to call Release. If an error occurs, the implementation sets *ppunk to NULL.
If the method succeeds, the return value is S_OK. Otherwise, it is E_FAIL.
A bind context maintains a table of interface pointers, each associated with a string key. This enables communication between a moniker implementation and the caller that initiated the binding operation. One party can store an interface pointer under a string known to both parties so that the other party can later retrieve it from the bind context.
The pointer this method retrieves must have previously been inserted into the table using the IBindCtx::RegisterObjectParam method.IBindCtx::RegisterObjectParam for more information.
Moniker implementations can call this method to handle situations where a caller initiates a binding operation and requests specific information. By convention, the implementer should use key names that begin with the string form of the CLSID of a moniker class. (See the StringFromCLSID function.)
|Minimum supported client||Windows 2000 Professional [desktop apps | UWP apps]|
|Minimum supported server||Windows 2000 Server [desktop apps | UWP apps]|