RevokeBindStatusCallback
Revokes a bind status callback interface previously registered on a bind context.
Syntax
HRESULT RevokeBindStatusCallback(
LPBC * pBC,
IBindStatusCallback * pBSCb
);
Parameters
- pBC
[in] Address of the IBindCtx interface for the bind context from which the callback interface is to be revoked. - pBSCb
[in] Address of the IBindStatusCallback interface to revoke.
Return Values
Returns one of the following values:
- S_OK
Success. - E_FAIL
The callback interface specified is not registered on the specified bind context. - E_INVALIDARG
One or more parameters are invalid.
Remarks
This function will not succeed if it is made during a bind operation.
Note It is not necessary to make this call for every use of a bind context. It is possible, although not recommended, to reuse the same bind context and the same callback for several bind operations. Upon calling the IUnknown::Release method, all registered objects on that bind context are revoked, including the callback interfaces. Therefore, releasing a bind context implicitly releases all registered callbacks. However, if you choose to reuse a bind context, you can use RevokeBindStatusCallback to remove a registered callback so it is not reused.
Requirements
Pocket PC: Pocket PC 2000 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: urlmon.h
Library: urlmon.lib
See Also
URL Moniker Services Functions | RegisterBindStatusCallback
Send Feedback on this topic to the authors