Export (0) Print
Expand All

IBindCtx::RevokeObjectParam method

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 with a call to RegisterObjectParam.

Syntax


HRESULT RevokeObjectParam(
  [in]  LPOLESTR pszKey
);

Parameters

pszKey [in]

The bind context string key to be removed. Key string comparison is case-sensitive.

Return value

This method can return the following values.

Return codeDescription
S_OK

The specified key was removed successfully.

S_FALSE

The object was not previously registered.

 

Remarks

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 also releases its reference to the object.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps | Windows Store apps]

Minimum supported server

Windows 2000 Server [desktop apps | Windows Store apps]

Header

ObjIdl.h

IDL

ObjIdl.idl

IID

IID_IBindCtx is defined as 0000000e-0000-0000-C000-000000000046

See also

IBindCtx

 

 

Community Additions

ADD
Show:
© 2014 Microsoft