WLAN_AVAILABLE_NETWORK 構造体 (wlanapi.h)
WLAN_AVAILABLE_NETWORK構造には、使用可能なワイヤレス ネットワークに関する情報が含まれています。
構文
typedef struct _WLAN_AVAILABLE_NETWORK {
WCHAR strProfileName[WLAN_MAX_NAME_LENGTH];
DOT11_SSID dot11Ssid;
DOT11_BSS_TYPE dot11BssType;
ULONG uNumberOfBssids;
BOOL bNetworkConnectable;
WLAN_REASON_CODE wlanNotConnectableReason;
ULONG uNumberOfPhyTypes;
DOT11_PHY_TYPE dot11PhyTypes[WLAN_MAX_PHY_TYPE_NUMBER];
BOOL bMorePhyTypes;
WLAN_SIGNAL_QUALITY wlanSignalQuality;
BOOL bSecurityEnabled;
DOT11_AUTH_ALGORITHM dot11DefaultAuthAlgorithm;
DOT11_CIPHER_ALGORITHM dot11DefaultCipherAlgorithm;
DWORD dwFlags;
DWORD dwReserved;
} WLAN_AVAILABLE_NETWORK, *PWLAN_AVAILABLE_NETWORK;
メンバー
strProfileName[WLAN_MAX_NAME_LENGTH]
ネットワークに関連付けられているプロファイル名が含まれます。 ネットワークにプロファイルがない場合、このメンバーは空になります。 ネットワークに複数のプロファイルが関連付けられている場合は、表示されるネットワーク リストに同じ SSID を持つ複数のエントリが存在します。 プロファイル名では大文字と小文字が区別されます。 この文字列は NULL で終わる必要があります。
dot11Ssid
可視ワイヤレス ネットワークの SSID を含む DOT11_SSID 構造。
dot11BssType
ネットワークがインフラストラクチャかアドホックかを指定する DOT11_BSS_TYPE 値。
uNumberOfBssids
ネットワーク内の BSID の数を示します。
SP3 の Windows XP と WINDOWS XP 用のワイヤレス LAN API SP2: uNumberofBssids は、SSID をブロードキャストするアクセス ポイントの数に関係なく、最大 1 です。
bNetworkConnectable
ネットワークが接続可能かどうかを示します。 TRUE に設定すると、ネットワークは接続可能になり、それ以外の場合はネットワークに接続できません。
wlanNotConnectableReason
ネットワークに接続できない理由を示すWLAN_REASON_CODE値。 このメンバーは、 bNetworkConnectable が FALSE の場合にのみ有効です。
uNumberOfPhyTypes
使用可能なネットワークでサポートされている PHY の種類の数。 uNumberOfPhyTypes の最大値はWLAN_MAX_PHY_TYPE_NUMBERで、値は 8 です。 複数WLAN_MAX_PHY_TYPE_NUMBER PHY 型がサポートされている場合は、bMorePhyTypes を TRUE に設定する必要があります。
dot11PhyTypes[WLAN_MAX_PHY_TYPE_NUMBER]
使用可能なネットワークでサポートされている PHY 型を表す DOT11_PHY_TYPE 値の配列を格納します。 uNumberOfPhyTypes がWLAN_MAX_PHY_TYPE_NUMBERより大きい場合、この配列には最初のWLAN_MAX_PHY_TYPE_NUMBER PHY 型のみが含まれます。
bMorePhyTypes
サポート されている PHY 型 がWLAN_MAX_PHY_TYPE_NUMBERを超えるかどうかを指定します。
このメンバーが TRUE に設定されている場合、アプリケーションは WlanGetNetworkBssList を呼び出して PHY の種類の完全な一覧を取得する必要があります。 返される WLAN_BSS_LIST 構造体には、 WLAN_BSS_ENTRY 構造体の配列があります。 WLAN_BSS_ENTRY 構造体の uPhyId メンバーには、エントリの PHY 型が含まれています。
wlanSignalQuality
ネットワークの信号品質を表すパーセンテージ値。 WLAN_SIGNAL_QUALITY は ULONG 型です。 このメンバーには、0 ~ 100 の値が含まれています。 値が 0 の場合は、実際の RSSI 信号強度が -100 dbm であることを意味します。 値が 100 の場合は、実際の RSSI 信号強度が -50 dbm であることを意味します。 線形補間を使用して、 wlanSignalQuality 値の 1 から 99 の RSSI 信号強度値を計算できます。
bSecurityEnabled
ネットワークでセキュリティが有効になっているかどうかを示します。 TRUE の値は、セキュリティが有効になっていることを示します。それ以外の場合は有効ではありません。
dot11DefaultAuthAlgorithm
このネットワークに初めて参加するために使用される既定の認証アルゴリズムを示す DOT11_AUTH_ALGORITHM 値。
dot11DefaultCipherAlgorithm
このネットワークに参加するときに使用される既定の暗号アルゴリズムを示す DOT11_CIPHER_ALGORITHM 値。
dwFlags
ネットワークのさまざまなフラグが含まれています。
| 値 | 意味 |
|---|---|
|
このネットワークは現在接続されています。 |
|
このネットワークのプロファイルがあります。 |
dwReserved
将来利用するために予約されています。 NULL に設定する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista、SP3 を使用した Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| Header | wlanapi.h |
| 再頒布可能パッケージ | Sp2 を使用した Windows XP 用ワイヤレス LAN API |