Share via

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 型のみが含まれます。

値 意味
dot11_phy_type_unknown
 不明または初期化されていない PHY 型を指定します。
dot11_phy_type_any
 任意の PHY タイプを指定します。
dot11_phy_type_fhss
 周波数ホッピング 拡散スペクトル (FHSS) PHY を指定します。 Bluetooth デバイスでは、FHSS または FHSS の適応を使用できます。
dot11_phy_type_dsss
 ダイレクト シーケンス 拡散スペクトル (DSSS) PHY を指定します。
dot11_phy_type_irbaseband
 赤外線 (IR) ベースバンド PHY を指定します。
dot11_phy_type_ofdm
 直交周波数分割多重 (OFDM) PHY を指定します。 802.11a デバイスでは OFDM を使用できます。
dot11_phy_type_hrdsss
 高レート DSSS (HRDSS) PHY を指定します。
dot11_phy_type_erp
 拡張レート PHY (ERP) を指定します。 802.11g デバイスでは ERP を使用できます。
dot11_phy_type_ht
 802.11n PHY 型を指定します。
dot11_phy_type_vht
 802.11ac PHY の種類を指定します。 これは、IEEE 802.11ac で指定されている非常に高スループットの PHY の種類です。

この値は、Windows 8.1、Windows Server 2012 R2 以降でサポートされています。
dot11_phy_type_IHV_start
 独立系ハードウェア ベンダー (IHV) によって開発される PHY 型を定義するために使用される範囲の開始を指定します。
dot11_phy_type_IHV_end
 独立系ハードウェア ベンダー (IHV) によって開発される 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

ネットワークのさまざまなフラグが含まれています。

値 意味
WLAN_AVAILABLE_NETWORK_CONNECTED
 このネットワークは現在接続されています。
WLAN_AVAILABLE_NETWORK_HAS_PROFILE
 このネットワークのプロファイルがあります。

dwReserved

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

要件

要件 値
サポートされている最小のクライアント Windows Vista、SP3 を使用した Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
Header wlanapi.h
再頒布可能パッケージ Sp2 を使用した Windows XP 用ワイヤレス LAN API

こちらもご覧ください

WLAN_AVAILABLE_NETWORK_LIST