Contents Index Topic Contents | ||
Previous Topic: ReleaseBindInfo Next Topic: RevokeFormatEnumerator |
RevokeBindStatusCallback
HRESULT RevokeBindStatusCallback( [in] IBindCtx *pbc, [in] IBindStatusCallback *pbsc );Revokes a bind status callback interface previously registered on a bind context.
- 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.
- pbc
- Address of the IBindCtx interface for the bind context from which the callback interface is to be revoked.
- pbsc
- Address of the IBindStatusCallback interface to revoke.
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 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.
See also IBindStatusCallback, RegisterBindStatusCallback
Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.