Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
CreateAsyncBindCtx
Collapse the table of content
Expand the table of content

CreateAsyncBindCtx function

Creates an asynchronous bind context for use with asynchronous monikers.

Syntax


HRESULT CreateAsyncBindCtx(
  _In_  DWORD               reserved,
  _In_  IBindStatusCallback *pBSCb,
  _In_  IEnumFORMATETC      *pEFetc,
  _Out_ IBindCtx            **ppBC
);

Parameters

reserved [in]

This parameter is reserved and must be 0.

pBSCb [in]

A pointer to the IBindStatusCallback interface used for receiving data availability and progress notification.

pEFetc [in]

A pointer to the IEnumFORMATETC interface that can be used to enumerate formats for format negotiation during binding. This parameter can be NULL, in which case the caller is not interested in format negotiation during binding, and the default format of the object will be bound to.

ppBC [out]

Address of an IBindCtx* pointer variable that receives the interface pointer to the new bind context.

Return value

This function can return the following values.

Return codeDescription
S_OK

The operation completed successfully.

E_OUTOFMEMORY

The method ran out of memory and did not complete.

E_INVALIDARG

One or more parameters are invalid.

 

Remarks

This function automatically registers the IBindStatusCallback and IEnumFORMATETC interfaces with the bind context. The client can specify flags from BSCO_OPTION to indicate which callback notifications the client is capable of receiving. If the client does not wish to receive certain notification, 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.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Urlmon.h

Library

Urlmon.lib

DLL

Urlmon.dll

See also

IBindStatusCallback
RegisterBindStatusCallback

 

 

Community Additions

ADD
Show:
© 2015 Microsoft