WFD_OPEN_SESSION_COMPLETE_CALLBACK コールバック関数 (wlanapi.h)

[アーティクル]
08/28/2023

WFD_OPEN_SESSION_COMPLETE_CALLBACK関数は、WFDStartOpenSession 操作が完了したときに WFDStartOpenSession 関数によって呼び出されるコールバック関数を定義します。

構文

WFD_OPEN_SESSION_COMPLETE_CALLBACK WfdOpenSessionCompleteCallback;

void WfdOpenSessionCompleteCallback(
  [in] HANDLE hSessionHandle,
  [in] PVOID pvContext,
  [in] GUID guidSessionInterface,
  [in] DWORD dwError,
  [in] DWORD dwReasonCode
)
{...}

パラメーター

[in] hSessionHandle

Wi-Fi Direct セッションへのセッションハンドル。これは、 WFDStartOpenSession 関数によって以前に返されたセッションハンドルです。

[in] pvContext

WFDStartOpenSession 関数からコールバック関数に渡されるコンテキストポインター。

[in] guidSessionInterface

この Wi-Fi Direct デバイスが開いているセッションを持つローカルネットワークインターフェイスのインターフェイス GUID。このパラメーターは、上位層プロトコルで、Wi-Fi Direct セッションがバインドされているネットワークインターフェイスを決定する必要がある場合に便利です。この値は、 dwError パラメーターがERROR_SUCCESS場合にのみ返されます。

[in] dwError

WFDStartOpenSession 関数の呼び出し中にエラーが発生したかどうかを示す値です。この値がERROR_SUCCESSの場合、エラーは発生せず、セッションを開く操作は正常に完了しました。

その他の値は次のとおりです。

値	意味
ERROR_INVALID_PARAMETER	パラメーターが正しくありません。このエラーは、 hClientHandle パラメーターが NULL または無効な場合に返されます。
ERROR_INVALID_STATE	グループまたはリソースが、要求された操作を実行するための正しい状態にありません。このエラーは、ドメインのグループポリシーによって Wi-Fi ダイレクトサービスが無効になっている場合に返されます。
ERROR_SERVICE_NOT_ACTIVE	サービスは開始されていません。このエラーは、WLAN AutoConfig サービスが実行されていない場合に返されます。
RPC_STATUS	さまざまな RPC とその他のエラーコード。 FormatMessage を使用して、返されたエラーのメッセージ文字列を取得します。

[in] dwReasonCode

WFDStartOpenSession 中にエラーが発生した場合の詳細を示す値。

戻り値

なし

解説

WFD_OPEN_SESSION_COMPLETE_CALLBACK関数は、Windows 8とWindows Server 2012の新機能である Wi-Fi Direct の一部です。 Wi-Fi Direct は、Wi-Fi Alliance による Wi-Fi ピアツーピア技術仕様 v1.1 の開発に基づいています ( 「Wi-Fi Alliance 公開仕様」を参照)。 Wi-Fi ピアツーピア技術仕様の目的は、ワイヤレスアクセスポイント (ワイヤレス AP) が接続をセットアップしたり、既存の Wi-Fi アドホック (IBSS) メカニズムを使用したりすることなく、デバイス間接続を Wi-Fi するためのソリューションを提供することです。

WFDStartOpenSession 関数は、特定の Wi-Fi Direct デバイスへのオンデマンド接続を開始する非同期操作を開始します。ターゲット Wi-Fi デバイスは、Windows ペアリングエクスペリエンスを通じて以前にペアリングされている必要があります。 Wi-FI 直接接続を行う非同期操作が完了すると、 pfnCallback パラメーターで指定されたコールバック関数が呼び出されます。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wlanapi.h