WLAN_BSS_ENTRY結構 (wlanapi.h)
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
與 BSS 相關聯的存取點 SSID (AP) 或對等站。 這個成員的數據類型是 DOT11_SSID 結構。
uPhyId
無線 LAN 介面用來偵測 BSS 網路的識別碼 (識別碼) 。
dot11Bssid
媒體訪問控制 (MAC) 基礎結構 BSS 網路或獨立 BSS 網路對等站的存取點位址， (臨機操作網路) 傳送無線 LAN 介面所接收的 802.11 指標或探查回應框架。 這個成員的數據類型是 DOT11_MAC_ADDRESS 結構。
dot11BssType
BSS 網路類型。 這個成員的數據類型是 DOT11_BSS_TYPE 列舉值。
這個成員可以是下列其中一個值。
| 值 | 意義 |
|---|---|
|
指定基礎結構 BSS 網路。 |
|
指定獨立 BSS (IBSS) 網路 (臨機操作網路) 。 |
dot11BssPhyType
此網路的 PHY 類型。 這個成員的數據類型是 DOT11_PHY_TYPE 列舉值。
lRssi
接收的訊號強度指標 (RSSI) 值，以 1.0 milliwatts (dBm) 所參考的單位表示，如 AP 或對等站的無線 LAN 介面驅動程式所偵測。
uLinkQuality
無線 LAN 介面驅動程式所報告的連結品質。 鏈接品質值的範圍從 0 到 100。 值為 100 指定最高的鏈接品質。
bInRegDomain
值，指定AP或對等站是否在法規網域內運作，如國家/地區所識別。
如果無線 LAN 介面驅動程式不支援多個法規網域，此成員會設定為 TRUE。
如果從AP或對等站收到的802.11指標或探查回應框架不包含國家/地區資訊元素 (IE) ，則此成員會設定為 TRUE。
如果從 AP 或對等站收到的 802.11 指標或探查回應框架包含國家/地區 IE，則如果 Country String 子字段的值不等於輸入國家/地區字串，則此成員會設定為 FALSE 。
usBeaconPeriod
無線 LAN 介面所收到的 802.11 指標或探查回應框架中的 [指標間隔] 字段值。
間隔介於目標指標傳輸時間之間的 1,024 微秒時間單位中。 此資訊是從基礎結構 BSS 網路中的存取點所傳送的指標封包擷取，或從存取點或對等站的探查回應擷取，以回應傳送探查要求的無線 LAN 用戶端。
IEEE 802.11 標準會將時間單位定義為等於 1,024 微秒。 已定義此單元，以便輕鬆地在硬體中實作。
ullTimestamp
來自無線 LAN 介面所接收之 802.11 指標或探查回應框架的 Timestamp 字段值。
ullHostTimestamp
無線 LAN 介面收到指標或探查回應框架時所記錄的主機時間戳值。 此成員是自 1601 年 1 月 1 日起的 100 奈秒間隔計數。
如需詳細資訊，請參閱 WDK 中所述的 NdisGetCurrentSystemTime 函式。
usCapabilityInformation
無線 LAN 介面所收到的 802.11 指標或探查回應框架中的 [功能資訊] 字段值。 這個值是定義功能的一組位旗標。
這個成員可以是下列一或多個值。
ulChCenterFrequency
收到802.11指標或探查響應畫面的訊號範圍中心頻率。 ulChCenterFrequency 的值為 kbhertz (kHz) 。
wlanRateSet
BSS 支援的一組數據傳輸速率。 這個成員的數據類型是 WLAN_RATE_SET 結構。
ulIeOffset
信息元素的位移，以位元組為單位，從WLAN_BSS_ENTRY 結構的開頭 (IE ) 數據 Blob。
此成員指向緩衝區，其中包含802.11指標或探查回應框架 (IES) 的可變長度資訊元素。 對於每個 BSS，IE 都是來自該 BSS 網路收到的最後一個指標或探查回應框架。 如果 IE 只能在一個畫面中使用，無線 LAN 介面驅動程式會將 IE 與最後一個收到的指標或探查回應框架中的其他 IE 合併。
資訊元素定義於 IEEE 802.11 規格中，其通用的一般格式包含 1 位元組元素標識元欄位、1 位元組長度欄位，以及可變長度專案特定資訊欄位。 每個資訊元素都會指派唯一的元素標識符值，如此 IEEE 802.11 標準中所定義。 [長度] 欄位元會指定資訊欄位中的位元組數目。
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 |