CreateAsyncBindCtx 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 for future use. 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

Returns one of the following values:

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 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.

Function Information

Windows NT	Use version 4.0. Implemented as a Unicode function.
Windows	Use Windows 95 and later. Implemented as a Unicode function.
Header	Urlmon.h
Import Library	Urlmon.lib
Minimum availability	Internet Explorer 3.0