WlanOpenHandle 関数 (wlanapi.h)
WlanOpenHandle 関数は、サーバーへの接続を開きます。
構文
DWORD WlanOpenHandle(
[in] DWORD dwClientVersion,
PVOID pReserved,
[out] PDWORD pdwNegotiatedVersion,
[out] PHANDLE phClientHandle
);
パラメーター
[in] dwClientVersion
クライアントがサポートする WLAN API の最高バージョン。
値 | 説明 |
---|---|
|
SP3 を使用した Windows XP のクライアント バージョンと、SP2 を使用した Windows XP 用ワイヤレス LAN API。 |
|
Windows Vista および Windows Server 2008 のクライアント バージョン |
pReserved
将来利用するために予約されています。 NULL に設定する必要があります。
[out] pdwNegotiatedVersion
このセッションで使用される WLAN API のバージョン。 通常、この値は、クライアントとサーバーの両方でサポートされる最高バージョンです。
[out] phClientHandle
このセッションで使用するクライアントのハンドル。 このハンドルは、セッション全体を通じて他の関数によって使用されます。
戻り値
関数が成功した場合、戻り値は ERROR_SUCCESS です。
関数が失敗した場合、戻り値は次のいずれかの戻りコードになる可能性があります。
リターン コード | 説明 |
---|---|
|
pdwNegotiatedVersion が NULL、 phClientHandle が NULL、または pReserved が NULL ではありません。 |
|
クライアント コンテキストを作成するためにメモリを割り当てませんでした。 |
|
さまざまなエラー コード。 |
|
サーバーによって発行されたハンドルが多すぎます。 |
解説
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 |