wlanapi.h) (WLAN_AVAILABLE_NETWORK 结构

项目
03/04/2024

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

通过

wlanapi.h) (WLAN_AVAILABLE_NETWORK 结构

语法

成员

要求

另请参阅

反馈

其他资源