RevokeBindStatusCallback
A version of this page is also available for
4/8/2010
This function revokes a bind status callback interface previously registered on a bind context.
Syntax
HRESULT RevokeBindStatusCallback(
IBindCtx* pbc,
IBindStatusCallback* pbsc
);
Parameters
- pbc
[in] Address of the IBindCtx interface for the bind context from which the callback interface is to be revoked.
- pbsc
[in] Address of the IBindStatusCallback interface to revoke.
Return Value
This function returns one of the values shown in the following table.
Value | Description |
---|---|
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 that 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 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
Header | urlmon.h, urlmon.idl |
Library | urlmon.lib |
Windows Embedded CE | Windows CE .NET 4.0 and later |
Windows Mobile | Windows Mobile Version 5.0 and later |