WlanOpenHandle 関数 (wlanapi.h)

  • [アーティクル]

WlanOpenHandle 関数は、サーバーへの接続を開きます。

構文

DWORD WlanOpenHandle(
  [in]  DWORD   dwClientVersion,
        PVOID   pReserved,
  [out] PDWORD  pdwNegotiatedVersion,
  [out] PHANDLE phClientHandle
);

パラメーター

[in] dwClientVersion

クライアントがサポートする WLAN API の最高バージョン。

値 説明
1
 SP3 を使用した Windows XP のクライアント バージョンと、SP2 を使用した Windows XP 用ワイヤレス LAN API。
2
 Windows Vista および Windows Server 2008 のクライアント バージョン

pReserved

将来利用するために予約されています。 NULL に設定する必要があります。

[out] pdwNegotiatedVersion

このセッションで使用される WLAN API のバージョン。 通常、この値は、クライアントとサーバーの両方でサポートされる最高バージョンです。

[out] phClientHandle

このセッションで使用するクライアントのハンドル。 このハンドルは、セッション全体を通じて他の関数によって使用されます。

戻り値

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

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

リターン コード 説明
ERROR_INVALID_PARAMETER
 pdwNegotiatedVersion が NULL、 phClientHandle が NULL、または pReserved が NULL ではありません。
ERROR_NOT_ENOUGH_MEMORY
 クライアント コンテキストを作成するためにメモリを割り当てませんでした。
RPC_STATUS
 さまざまなエラー コード。
ERROR_REMOTE_SESSION_LIMIT_EXCEEDED
 サーバーによって発行されたハンドルが多すぎます。

解説

dwClientVersion と pdwNegotiatedVersion で指定されたバージョン番号は、メジャー バージョンとマイナー バージョンの両方で構成される複合バージョン番号です。 メジャー バージョンは下位ワードで指定され、マイナー バージョンは上位ワードで指定されます。 マクロ WLAN_API_VERSION_MAJOR(_v) と WLAN_API_VERSION_MINOR(_v) は、それぞれメジャー バージョン番号とマイナー バージョン番号を返します。 マクロ WLAN_API_MAKE_VERSION(_major, _minor)を使用してバージョン番号を作成できます。

SP3 の Windows XP と Windows XP 用のワイヤレス LAN API SP2: WlanOpenHandle は、ワイヤレス ゼロ構成 (WZC) サービスが開始されていない場合、または WZC サービスが応答しない場合にエラー メッセージを返します。

要件

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

関連項目

WlanCloseHandle