Win32 API 日本語リファレンス
ホーム › NetworkManagement.WiFi › WFD_OPEN_SESSION_COMPLETE_CALLBACK

WFD_OPEN_SESSION_COMPLETE_CALLBACK

コールバック

シグネチャ

void WFD_OPEN_SESSION_COMPLETE_CALLBACK(
    HANDLE hSessionHandle,
    void* pvContext,
    GUID guidSessionInterface,
    DWORD dwError,
    DWORD dwReasonCode
);

パラメーター

フィールド型説明
hSessionHandleHANDLEWi-Fi Direct セッションのセッションハンドルです。これは、WFDStartOpenSession 関数が以前に返したセッションハンドルです。
pvContextvoid*WFDStartOpenSession 関数からコールバック関数に渡されるコンテキストポインターです。
guidSessionInterfaceGUIDこの Wi-Fi Direct デバイスがセッションを開いているローカルネットワークインターフェイスのインターフェイス GUID です。 このパラメーターは、上位層のプロトコルが Wi-Fi Direct セッションのバインド先となるネットワークインターフェイスを判別する必要がある場合に役立ちます。 この値は、dwError パラメーターが ERROR_SUCCESS の場合にのみ返されます。
dwErrorDWORD

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

このほかに、次の値が返される可能性があります。

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

公式ドキュメント

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

解説(Remarks)

WFD_OPEN_SESSION_COMPLETE_CALLBACK 関数は、Windows 8 および Windows Server 2012 の新機能である Wi-Fi Direct の一部です。Wi-Fi Direct は、Wi-Fi Alliance による Wi-Fi Peer-to-Peer Technical Specification v1.1 の策定に基づいています (Wi-Fi Alliance Published Specifications を参照してください)。Wi-Fi Peer-to-Peer Technical Specification の目的は、接続を設定するためのワイヤレスアクセスポイント (ワイヤレス AP) や既存の Wi-Fi アドホック (IBSS) の仕組みを必要とせずに、Wi-Fi デバイス間で直接接続するための手段を提供することです。

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)