Partager via


RevokeBindStatusCallback

A version of this page is also available for

Windows Embedded CE 6.0 R3

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