CreateAsyncBindCtx function

Creates an asynchronous bind context for use with asynchronous monikers.

Syntax

HRESULT CreateAsyncBindCtx(
  _Reserved_ DWORD               dwReserved,
  _In_       IBindStatusCallback *pbsc,
  _In_       IEnumFORMATETC      *penumfmtetc,
  _Out_      IBindCtx            **ppbc
);

Parameters

• dwReserved [in]
  Reserved. Must be set to 0.

• pbsc [in]
  A pointer to the IBindStatusCallback interface used to receive data availability and progress notifications.

• penumfmtetc [in]
  A pointer to the IEnumFORMATETC interface that can be used to enumerate formats for format negotiation during binding. If this parameter is NULL, the calling application does not receive format negotiation during binding, and the default format of the object is bound to it.

• ppbc [out]
  Pointer to the IBindCtx interface of the new bind context.

Return value

Returns one of the following values.

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