CreateAsyncBindCtx function

Článek
07/13/2016

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

Sdílet prostřednictvím