次の方法で共有


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

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

こちらもご覧ください

WFDCancelOpenSession

WFDCloseHandle

WFDCloseSession

WFDOpenHandle

WFDStartOpenSession

WFD_OPEN_SESSION_COMPLETE_CALLBACK