RevokeBindStatusCallback function

Revokes a bind status callback interface previously registered on a bind context.

Syntax

HRESULT RevokeBindStatusCallback(
  _In_ IBindCtx            *pbc,
  _In_ IBindStatusCallback *pbsc
);

Parameters

  • pbc [in]
    The address of the IBindCtx interface for the bind context from which the callback interface is revoked.

  • pbsc [in]
    The address of the IBindStatusCallback interface to revoke.

Return value

Returns one of the following values.

Return code Description
S_OK

Successful.

E_FAIL

The callback interface specified is not registered on the specified bind context.

E_INVALIDARG

One or more parameters is invalid.

 

Remarks

This function will not succeed if it is made during a bind operation.

Note  You don't have to make this call for every use of a bind context. Although it is not recommended, it is possible to reuse the same bind context and the same callback for several bind operations. After the Release method is called, all registered objects on that bind context are revoked, including the callback interfaces. Releasing a bind context implicitly releases all registered callbacks. If you want to reuse a bind context, you can use RevokeBindStatusCallback to remove a registered callback so that it is not reused.

 

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Product

Internet Explorer 3.0

Header

Urlmon.h

Library

Urlmon.lib

DLL

Urlmon.dll

See also

RegisterBindStatusCallback