Partager via


CreateAsyncBindCtx

A version of this page is also available for

Windows Embedded CE 6.0 R3

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