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
1 つ以上のパラメーターが無効です。

解説

この関数は、 IBindStatusCallback インターフェイスと IEnumFORMATETC インターフェイスをバインド コンテキストに自動的に登録します。 クライアントは、BSCO_OPTIONからのフラグを指定して、クライアントが受信できるコールバック通知を示すことができます。 クライアントが特定の通知を受信したくない場合は、これらのコールバック メソッドを空の関数スタブ (E_NOTIMPLを返す) として実装することを選択でき、呼び出さないでください。

RegisterBindStatusCallback 関数を使用して、バインド コンテキストにコールバック インターフェイスを登録することもできます。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー urlmon.h
Library Urlmon.lib
[DLL] Urlmon.dll

関連項目

IBindStatusCallback

RegisterBindStatusCallback