WFDStartOpenSession 関数 (wlanapi.h)

[アーティクル]
12/22/2023

WFDStartOpenSession 関数は、Windows ペアリングエクスペリエンスを通じて以前にペアリングされた特定の Wi-Fi Direct デバイスへのオンデマンド接続を開始します。

構文

DWORD WFDStartOpenSession(
  [in]           HANDLE                             hClientHandle,
  [in]           PDOT11_MAC_ADDRESS                 pDeviceAddress,
  [in, optional] PVOID                              pvContext,
  [in]           WFD_OPEN_SESSION_COMPLETE_CALLBACK pfnCallback,
  [out]          PHANDLE                            phSessionHandle
);

パラメーター

[in] hClientHandle

Wi-Fi Direct サービスへのクライアントハンドル。このハンドルは、 WFDOpenHandle 関数の以前の呼び出しによって取得されました。

[in] pDeviceAddress

ターゲットデバイスの Wi-Fi Direct デバイスアドレスへのポインター。これは、ターゲット Wi-Fi デバイスの MAC アドレスです。

[in, optional] pvContext

pfnCallback パラメーターで指定されたコールバック関数に渡される省略可能なコンテキストポインター。

[in] pfnCallback

WFDStartOpenSession 要求が完了した後に呼び出されるコールバック関数へのポインター。

[out] phSessionHandle

この特定の Wi-Fi Direct セッションへのハンドル。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS です。

関数が失敗した場合、戻り値は次のいずれかの戻りコードになる可能性があります。

リターンコード	説明
ERROR_INVALID_HANDLE	ハンドルが正しくありません。このエラーは、 hClientHandle パラメーターで指定されたハンドルがハンドルテーブルで見つからなかった場合に返されます。
ERROR_INVALID_PARAMETER	パラメーターが正しくありません。このエラーは、 hClientHandle パラメーターが NULL または無効な場合に返されます。このエラーは、 pDeviceAddress パラメーターが NULL、 pfnCallback パラメーターが NULL、 phSessionHandle パラメーターが NULL の場合にも返されます。 dwClientVersion パラメーターが WFD_API_VERSION と等しくない場合も、この値が返されます。
ERROR_INVALID_STATE	グループまたはリソースが、要求された操作を実行するための正しい状態にありません。このエラーは、ドメインのグループポリシーによって Wi-Fi ダイレクトサービスが無効になっている場合に返されます。
ERROR_SERVICE_NOT_ACTIVE	サービスは開始されていません。このエラーは、WLAN AutoConfig サービスが実行されていない場合に返されます。
RPC_STATUS	さまざまなエラーコード。

注釈

WFDStartOpenSession 関数は、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 ペアリングエクスペリエンスを通じて以前にペアリングされている必要があります。非同期操作が完了すると、 pfnCallback パラメーターで指定されたコールバック関数が呼び出されます。

WFDStartOpenSession 関数が非同期的に完了する前に WFDCloseHandle 関数を呼び出して、アプリケーションが Wi-Fi Direct サービスへのハンドルを閉じようとすると、WFDCloseHandle 関数は WFDStartOpenSession 呼び出しが完了するまで待機します。

要件

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