createAsyncBindCtx 函数 (urlmon.h)

创建用于异步名字对象的异步绑定上下文。

语法

HRESULT CreateAsyncBindCtx(
  [in]  DWORD               reserved,
  [in]  IBindStatusCallback *pBSCb,
  [in]  IEnumFORMATETC      *pEFetc,
  [out] IBindCtx            **ppBC
);

参数

[in] reserved

此参数是保留的,必须为 0。

[in] pBSCb

指向用于接收数据可用性和进度通知的 IBindStatusCallback 接口的指针。

[in] pEFetc

指向 IEnumFORMATETC 接口的指针,可用于枚举绑定期间格式协商的格式。 此参数可以为 NULL,在这种情况下,调用方对绑定期间的格式协商不感兴趣,对象的默认格式将被绑定到。

[out] ppBC

接收指向新绑定上下文的接口指针的 IBindCtx* 指针变量的地址。

返回值

此函数可以返回以下值。

返回代码 说明
S_OK
操作已成功完成。
E_OUTOFMEMORY
方法内存不足,未完成。
E_INVALIDARG
一个或多个参数无效。

注解

此函数会自动将 IBindStatusCallbackIEnumFORMATETC 接口注册到绑定上下文。 客户端可以指定来自BSCO_OPTION的标志,以指示客户端能够接收哪些回调通知。 如果客户端不希望接收特定通知,可以选择将这些回调方法实现为空函数存根 (返回E_NOTIMPL) ,并且不应调用它们。

RegisterBindStatusCallback 函数还可用于在绑定上下文中注册回调接口。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 urlmon.h
Library Urlmon.lib
DLL Urlmon.dll

另请参阅

IBindStatusCallback

RegisterBindStatusCallback