Share via

WlanCloseHandle 関数 (wlanapi.h)

  • [アーティクル]

WlanCloseHandle 関数は、サーバーへの接続を閉じます。

構文

DWORD WlanCloseHandle(
  [in] HANDLE hClientHandle,
       PVOID  pReserved
);

パラメーター

[in] hClientHandle

閉じる接続を識別するクライアントのセッション ハンドル。 このハンドルは、 WlanOpenHandle 関数の以前の呼び出しによって取得されました。

pReserved

将来利用するために予約されています。 このパラメーターを NULL に設定 します。

戻り値

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

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

リターン コード 説明
ERROR_INVALID_PARAMETER
 hClientHandle が NULL または無効であるか、 pReserved が NULL ではありません。
ERROR_INVALID_HANDLE
 ハンドル テーブルにハンドル hClientHandle が見つかりませんでした。
RPC_STATUS
 さまざまなエラー コード。

解説

接続が閉じられた後、閉じたハンドルを使用しようとすると、予期しないエラーが発生する可能性があります。 閉じると、未処理のすべての通知が破棄されます。

コールバック関数から WlanCloseHandle を呼び出さないでください。 WlanCloseHandle が呼び出されたときにクライアントが通知コールバックの途中にある場合、関数はコールバックが完了するまで待機してから値を返します。 コールバック関数内でこの関数を呼び出すと、呼び出しは完了しません。 コールバック関数とハンドルを閉じるスレッドの両方が同じロックを取得しようとすると、デッドロックが発生する可能性があります。 さらに、アプリケーション DLL の DllMain 関数から WlanCloseHandle を呼び出さないでください。 これにより、デッドロックが発生する可能性もあります。

要件

   
サポートされている最小のクライアント Windows Vista、WINDOWS XP と SP3 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wlanapi.h (Wlanapi.h を含む)
Library Wlanapi.lib
[DLL] Wlanapi.dll
再頒布可能パッケージ Sp2 を使用した Windows XP 用ワイヤレス LAN API

関連項目

WlanOpenHandle