WFDOpenHandle 関数 (wlanapi.h)

[アーティクル]
03/04/2024

WFDOpenHandle 関数は、Wi-Fi Direct サービスへのハンドルを開き、使用する Wi-FI Direct API のバージョンをネゴシエートします。

構文

DWORD WFDOpenHandle(
  [in]  DWORD   dwClientVersion,
  [out] PDWORD  pdwNegotiatedVersion,
  [out] PHANDLE phClientHandle
);

パラメーター

[in] dwClientVersion

クライアントがサポートする Wi-Fi Direct API の最上位バージョン。

Windows 8とWindows Server 2012の場合、このパラメーターは Wlanapi.h ヘッダーファイルで定義されている定数WFD_API_VERSIONに設定する必要があります。

[out] pdwNegotiatedVersion

ネゴシエートされたバージョンを受け取る DWORD へのポインター。

WFDOpenHandle 関数が正常に終了すると、このセッションで使用される Wi-Fi Direct Service とネゴシエートされたバージョンが返されます。通常、この値は、クライアントと Wi-Fi Direct サービスの両方でサポートされる最高バージョンです。

[out] phClientHandle

このセッションの Wi-Fi Direct サービスへのハンドルを受け取る HANDLE へのポインター。

WFDOpenHandle 関数が成功した場合は、このセッションで使用する Wi-Fi Direct サービスへのハンドルが返されます。

戻り値

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

関数が失敗した場合、戻り値は次のいずれかのリターンコードになります。

リターンコード	説明
ERROR_INVALID_PARAMETER	パラメーターが正しくありません。 pdwNegotiatedVersion パラメーターが NULL であるか、phClientHandle パラメーターが NULL の場合、このエラーが返されます。 dwClientVersion パラメーターがWFD_API_VERSIONと等しくない場合も、この値が返されます。
ERROR_NOT_ENOUGH_MEMORY	このコマンドを処理するのに十分なストレージがありません。このエラーは、システムがクライアントコンテキストを作成するためにメモリを割り当てられなかった場合に返されます。
ERROR_REMOTE_SESSION_LIMIT_EXCEEDED	ネットワークサーバーへのセッションを確立しようとしましたが、そのサーバーに対して確立されているセッションが既に多すぎます。このエラーは、Wi-Fi Direct サービスによって発行されたハンドルが多すぎる場合に返されます。
RPC_STATUS	さまざまなエラーコード。

注釈

WFDOpenHandle 関数は、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 するためのソリューションを提供することです。

Wi-Fi Direct を使用するには、アプリケーションはまず WFDOpenHandle 関数を呼び出して、Wi-Fi Direct サービスへのハンドルを取得する必要があります。 WFDOpenHandle 関数によって返される Wi-Fi Direct (WFD) ハンドルは、Wi-Fi Direct サービスへの後続の呼び出しに使用されます。 Wi-Fi Direct サービスを使用してアプリケーションが完了したら、アプリケーションは WFDCloseHandle 関数を呼び出して、アプリケーションがサービスを使用して実行されたことを Wi-Fi Direct サービスに通知する必要があります。これにより、Wi-Fi Direct サービスは、アプリケーションで使用されるリソースを解放できます。

要件

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