WFDCloseSession 関数 (wlanapi.h)

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

WFDCloseSession 関数は、WFDStartOpenSession 関数を以前に正常に呼び出した後にセッションを閉じます。

構文

DWORD WFDCloseSession(
  [in] HANDLE hSessionHandle
);

パラメーター

[in] hSessionHandle

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

戻り値

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

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

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

注釈

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

WFDCloseSession 関数は、セッションを閉じる将来の作業項目をキューに入れます。そのため、切断はすぐには実行されない可能性があります。

WFDStartOpenSession 呼び出しが保留中の間に WFDCloseSession 関数を呼び出すと、セッションは閉じません。

WFDCloseSession 関数に対する正常な非同期呼び出しから返された hSessionHandle パラメーターのハンドルを WFDCloseSession 関数に渡す必要があります。

有効で無効になったハンドルを使用して WFDCloseSession 関数を呼び出すと、未定義の結果が生成されます。

要件

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