WLAN_BSS_ENTRY 结构 (wlanapi.h)

项目
03/04/2024

WLAN_BSS_ENTRY结构包含有关 BSS) (基本服务集的信息。

语法

typedef struct _WLAN_BSS_ENTRY {
  DOT11_SSID        dot11Ssid;
  ULONG             uPhyId;
  DOT11_MAC_ADDRESS dot11Bssid;
  DOT11_BSS_TYPE    dot11BssType;
  DOT11_PHY_TYPE    dot11BssPhyType;
  LONG              lRssi;
  ULONG             uLinkQuality;
  BOOLEAN           bInRegDomain;
  USHORT            usBeaconPeriod;
  ULONGLONG         ullTimestamp;
  ULONGLONG         ullHostTimestamp;
  USHORT            usCapabilityInformation;
  ULONG             ulChCenterFrequency;
  WLAN_RATE_SET     wlanRateSet;
  ULONG             ulIeOffset;
  ULONG             ulIeSize;
} WLAN_BSS_ENTRY, *PWLAN_BSS_ENTRY;

成员

dot11Ssid

接入点的 SSID (与 BSS 关联的 AP) 或对等站。此成员的数据类型是 DOT11_SSID 结构。

uPhyId

标识符 (无线 LAN 接口用于检测 BSS 网络的 PHY) ID。

dot11Bssid

媒体访问控制 (MAC) 用于基础结构 BSS 网络的接入点或独立 BSS 网络的对等站的地址， (即席网络) 发送扫描时无线 LAN 接口接收的 802.11 信标或探测响应帧。此成员的数据类型是 DOT11_MAC_ADDRESS 结构。

dot11BssType

BSS 网络类型。此成员的数据类型是 DOT11_BSS_TYPE 枚举值。

此成员可以是以下值之一。

值	含义
dot11_BSS_type_infrastructure 1	指定基础结构 BSS 网络。
dot11_BSS_type_independent 2	指定一个独立的 BSS (IBSS) 网络 (即席网络) 。

dot11BssPhyType

此网络的 PHY 类型。此成员的数据类型是 DOT11_PHY_TYPE 枚举值。

lRssi

接收的信号强度指示器 (RSSI) 值，以分贝为单位，引用为 1.0 毫瓦 (dBm) ，由 AP 或对等站的无线 LAN 接口驱动程序检测到。

uLinkQuality

无线 LAN 接口驱动程序报告的链路质量。链接质量值的范围是 0 到 100。值为 100 指定最高的链接质量。

bInRegDomain

一个值，该值指定 AP 或对等站是否在由国家/地区标识的监管域中运行。

如果无线 LAN 接口驱动程序不支持多个监管域，则此成员设置为 TRUE。

如果从 AP 或对等站接收的 802.11 信标或探测响应帧不包含国家/地区信息元素 (IE) ，则此成员设置为 TRUE。

如果从 AP 或对等站接收的 802.11 信标或探测响应帧包含国家/地区 IE，则如果“国家/地区字符串”子字段的值不等于输入国家/地区字符串，则此成员将设置为 FALSE 。

usBeaconPeriod

无线 LAN 接口接收的 802.11 信标或探测响应帧中的信标间隔字段的值。

目标信标传输时间之间的间隔为 1,024 微秒时间单位。此信息从基础结构 BSS 网络中的接入点发送的信标数据包中检索，或者从接入点或对等站的探测响应中检索，以响应发送探测请求的无线 LAN 客户端。

IEEE 802.11 标准将时间单位定义为等于 1,024 微秒。此单元已定义，以便在硬件中轻松实现。

ullTimestamp

无线 LAN 接口接收的 802.11 信标或探测响应帧中的时间戳字段的值。

ullHostTimestamp

当无线 LAN 接口收到信标或探测响应帧时记录的主机时间戳值。此成员是自 1601 年 1 月 1 日以来的 100 纳秒间隔计数。

有关详细信息，请参阅 WDK 中记录的 NdisGetCurrentSystemTime 函数。

usCapabilityInformation

无线 LAN 接口接收的 802.11 信标或探测响应帧中的“功能信息”字段的值。此值是定义功能的一组位标志。

此成员可以是以下一个或多个值。

值	含义
Ess 位 0	扩展服务集。 (BSSs) 和集成的局域网 (LAN) 的一组互连基本服务集，这些服务集显示为与其中一个 BSS 关联的任何工作站上的逻辑链路控制层的单个 BSS。 AP 在传输的信标或探测响应帧内，将 ESS 子字段设置为 1，IBSS 子字段设置为 0。 IBSS (临时网络中的对等站) 在传输的信标或探测响应帧中将 ESS 子字段设置为 0，IBSS 子字段设置为 1。
IBSS bit 1	独立的基本服务集。构成自包含网络的 BSS，其中无法访问分发系统 (DS) (临时网络) 。 AP 在传输的信标或探测响应帧内，将 ESS 子字段设置为 1，IBSS 子字段设置为 0。 IBSS (临时网络中的对等站) 在传输的信标或探测响应帧中将 ESS 子字段设置为 0，IBSS 子字段设置为 1。
CF-Pollable 位 2	一个值，该值指示 AP 或对等站是否可轮询。
CF 轮询请求位 3	一个值，该值指示 AP 或对等站如何处理轮询请求。
隐私 bit 4	一个值，该值指示所有数据帧是否需要加密。如果 BSS 中交换的所有数据类型帧需要 WEP、WPA 或 WPA2 加密，则 AP 会将“隐私”子字段设置为 1（在传输的信标和探测响应帧内）。如果不需要 WEP、WPA 或 WPA2 加密，“隐私”子字段将设置为 0。如果 IBSS 中交换的所有数据类型帧需要 WEP、WPA 或 WPA2 加密，则和 IBSS 中的对等站将“隐私”子字段设置为 1（在传输的信标和探测响应帧中）。如果不需要 WEP、WPA 或 WPA2 加密，“隐私”子字段将设置为 0。

ulChCenterFrequency

接收 802.11 信标或探测响应帧的频带的通道中心频率。 ulChCenterFrequency 的值以千赫 (kHz) 为单位。

注意此成员仅适用于非跳频扩展频谱 (FHSS) 的 PHY 类型。

wlanRateSet

BSS 支持的一组数据传输速率。此成员的数据类型是 WLAN_RATE_SET 结构。

ulIeOffset

信息元素 (IE) 数据 blob 的偏移 量（以字节为单位 ）从WLAN_BSS_ENTRY结构开头。

此成员指向一个缓冲区，该缓冲区包含来自 802.11 信标或探测响应帧 (IE) 的可变长度信息元素。对于每个 BSS，IE 来自从该 BSS 网络接收的最后一个信标或探测响应帧。如果 IE 仅在一个帧中可用，则无线 LAN 接口驱动程序会将 IE 与上次接收的信标或探测响应帧中的其他 IE 合并。

信息元素在 IEEE 802.11 规范中定义为具有通用的常规格式，其中包括 1 字节元素 ID 字段、1 字节 Length 字段和特定于可变长度元素的信息字段。每个信息元素都分配有在此 IEEE 802.11 标准中定义的唯一元素 ID 值。 Length 字段指定信息字段中的字节数。

ulIeSize

WLAN_BSS_ENTRY结构中 IE 数据 Blob 的大小（以字节为单位）。

这是 ulIeOffset 成员指向的缓冲区中的数据的确切长度，不包含任何对齐填充。 IE 数据 Blob 大小的最大值为 2,324 字节。

注解

WlanGetNetworkBssList 函数检索给定接口上无线网络或网络的 BSS 列表，并在包含数组的WLAN_BSS_LIST结构中返回此信息。WLAN_BSS_ENTRY结构。

当无线 LAN 接口也作为无线托管网络运行时，BSS 列表将包含为无线托管网络创建的 BSS 的条目。

由于信息由基础结构 BSS 网络的接入点返回，或者由独立 BSS 网络的网络对等方 (临时网络) 返回，因此不应信任返回的信息。应使用 WLAN_BSS_ENTRY 结构中的 ulIeOffset 和 ulIeSize 成员来确定WLAN_BSS_ENTRY结构中信息元素数据 Blob 的最大大小，而不是信息元素数据 Blob 中的数据。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	wlanapi.h

另请参阅

WLAN_AVAILABLE_NETWORK

WLAN_AVAILABLE_NETWORK_LIST

WLAN_BSS_LIST

WlanGetAvailableNetworkList

WlanGetNetworkBssList

通过

WLAN_BSS_ENTRY 结构 (wlanapi.h)

语法

成员

注解

要求

另请参阅

反馈

其他资源