IBindCtx::RevokeObjectParam

Removes the specified key and its associated pointer from the bind context's string-keyed table of objects. The key must have previously been inserted into the table using the IBindCtx::RegisterObjectParam method.

HRESULT RevokeObjectParam(

LPOLESTR pszKey	//Points to the key to be revoked
);

Parameter
pszKey

[in] Points to a zero-terminated string containing the key to remove. For Win32 applications, the LPOLESTR type indicates a wide character string (two bytes per character); otherwise, the string has one byte per character. Key string comparsion is case sensitive.

Return Values
S_OK

The specified key was successfully removed from the table.

S_FALSE

Indicates that no object has been registered with the specified key.

Comments
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.

This method is used to remove an entry from the table. If the specified key is found, the bind context releases its reference to the object.