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.

Return code 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 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

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Product

Internet Explorer 3.0

Header

 Urlmon.h

Library

 Urlmon.lib

DLL

 Urlmon.dll