Contents Index Topic Contents | ||
Previous Topic: RevokeBindStatusCallback Next Topic: URLDownloadToCacheFile |
RevokeFormatEnumerator
HRESULT RevokeFormatEnumerator( [in] LPBC pbc, [in] IEnumFORMATETC *pEFetc );Removes a format enumerator from the given bind context.
- Returns S_OK if the enumerator was successfully removed, or E_INVALIDARG if one or more parameters are invalid.
- pbc
- Address of the IBindCtx interface for the bind context from which the enumerator is to be revoked.
- pEFetc
- Address of the IEnumFORMATETC interface for the enumerator to revoke.
This function removes a format enumerator from the bind context specified in pbc. It must previously have been registered with a call to RegisterFormatEnumerator.
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 format enumerator for several bind operations. Upon calling IUnknown::Release, all registered objects on that bind context are revoked, including the format enumerator interfaces. Therefore, releasing a bind context implicitly releases all registered format enumerators. However, if you choose to reuse a bind context, you can use RevokeFormatEnumerator to remove a registered format enumerator so it is not reused.
See also RegisterFormatEnumerator
Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.