Contents Index Topic Contents
	Previous Topic: CopyStgMedium Next Topic: CreateAsyncBindCtxEx

CreateAsyncBindCtx

HRESULT CreateAsyncBindCtx(
    [in] DWORD dwReserved,
    [in] IBindStatusCallback *pbsc,
    [in] IEnumFORMATETC *penumfmtetc,
    [out] IBindCtx **ppbc
);

Creates an asynchronous bind context for use with asynchronous monikers.

• Returns one of the following values:

  S_OK	Success.
  E_INVALIDARG	One or more parameters are invalid.
  E_OUTOFMEMORY	The method ran out of memory and did not complete.

dwReserved

Reserved for future use; must be zero.

pbsc

Address of the IBindStatusCallback interface used for receiving data availability and progress notification.

penumfmtetc

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

Indirect pointer to the IBindCtx interface for the new bind context.

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.

See also IBindStatusCallback, RegisterBindStatusCallback

---

 Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.