RevokeBindStatusCallback 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

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.

Function Information

Windows NT	Use version 4.0. Implemented as a Unicode function.
Windows	Use Windows 95 and later. Implemented as a Unicode function.
Header	Urlmon.h
Import Library	Urlmon.lib
Minimum availability	Internet Explorer 3.0

Windows CE

Windows CE	Use version 2.12 and later
Minimum availability	Internet Explorer 4.0

See Also

RegisterBindStatusCallback