CreateAsyncBindCtx
A version of this page is also available for
4/8/2010
This function creates an asynchronous bind context for use with asynchronous monikers.
Syntax
HRESULT CreateAsyncBindCtx(
DWORD dwReserved,
IBindStatusCallback* pbsc,
IEnumFORMATETC* penumfmtetc,
IBindCtx** ppbc
);
Parameters
- dwReserved
[in] Reserved. Must be zero.
- pbsc
[in] Address of the IBindStatusCallback interface used for receiving data availability and progress notifications.
- penumfmtetc
[in] 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
[out] Address of a pointer to the IBindCtx interface of the new bind context.
Return Value
This function returns one of the values shown in the following table.
Value | Description |
---|---|
S_OK |
Success. |
E_INVALIDARG |
One or more parameters are invalid. |
E_OUTOFMEMORY |
The function ran out of memory and did not complete. |
Remarks
This function automatically registers the IBindStatusCallback and the IEnumFORMATETC interfaces with the bind context. If the client does not require certain notifications, the callback methods may be implemented as empty function stubs (returning E_NOTIMPL).
The RegisterBindStatusCallback function can also be used to register callback interfaces in the bind context.
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 |