Share via

wlanapi.h) (WLAN_AVAILABLE_NETWORK 结构

  • 项目

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

指示网络中 BSSSD 的数目。

带 SP3 的 Windows XP 和适用于具有 SP2 的 Windows XP 的无线 LAN API： uNumberofBssids 最多为 1，无论广播 SSID 的接入点数量如何。

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]

包含 DOT11_PHY_TYPE 值的数组，这些值表示可用网络支持的 PHY 类型。 当 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 的频率跳跃扩展谱。 蓝牙设备可以使用 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 (HRDSSS) 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

指定是否支持超过 WLAN_MAX_PHY_TYPE_NUMBER PHY 类型。

当此成员设置为 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。 可以使用线性内插计算 1 到 99 之间的 wlanSignalQuality 值的 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、Windows XP SP3 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 wlanapi.h
可再发行组件 带有 SP2 的 Windows XP 无线 LAN API

另请参阅

WLAN_AVAILABLE_NETWORK_LIST