Contents Index Topic Contents | ||
Previous Topic: CopyStgMedium Next Topic: CreateAsyncBindCtxEx |
CreateAsyncBindCtx
HRESULT CreateAsyncBindCtx( [in] DWORD dwReserved, [in] IBindStatusCallback *pbsc, [in] IEnumFORMATETC *penumfmtetc, [out] IBindCtx **ppbc );Creates an asynchronous bind context for use with asynchronous monikers.
- Returns one of the following values:
S_OK Success. E_INVALIDARG One or more parameters are invalid. E_OUTOFMEMORY The method ran out of memory and did not complete.
- dwReserved
- Reserved for future use; must be zero.
- pbsc
- Address of the IBindStatusCallback interface used for receiving data availability and progress notification.
- penumfmtetc
- Address of the IEnumFORMATETC interface that can be used to enumerate formats for format negotiation during binding. This parameter can be NULL, in which case the calling application is not interested in format negotiation during binding, and the default format of the object will be bound to it.
- ppbc
- Indirect pointer to the IBindCtx interface for the new bind context.
This function automatically registers the IBindStatusCallback and the IEnumFORMATETC interfaces with the bind context. If the client does not want to receive certain notifications, it can choose to implement those callback methods as empty function stubs (returning E_NOTIMPL), and they should not be called.
The RegisterBindStatusCallback function can also be used to register callback interfaces in the bind context.
See also IBindStatusCallback, RegisterBindStatusCallback
Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.