共用方式為

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 列舉值。

這個成員可以是下列其中一個值。

值 意義
dot11_BSS_type_infrastructure
1
 指定基礎結構 BSS 網路。
dot11_BSS_type_independent
2
 指定獨立 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 指標或探查回應框架中的 [功能資訊] 字段值。 這個值是定義功能的一組位旗標。

這個成員可以是下列一或多個值。

值 意義
Ess
位0
 擴充服務集。 一組一或多個互連的基本服務集 (BSs) 和整合式局域網路 (LAN) ，這些局域網路會在與其中一個 BSS 相關聯的任何站台上顯示為邏輯連結控制層的單一 BSS。

AP 會將 ESS 子字段設定為 1，而 IBSS 子欄位會在傳輸的指標或探查回應框架內設定為 0。 IBSS 內的對等站 (臨機操作網路) 將 ESS 子欄位設定為 0，並將傳輸指標或探查回應框架中的 IBSS 子字段設定為 1。
IBSS
位1
 獨立的基本服務集。 形成獨立網路的 BSS，且無法存取散發系統 (DS) ， (臨機操作網路) 。

AP 會將 ESS 子字段設定為 1，而 IBSS 子欄位會在傳輸的指標或探查回應框架內設定為 0。 IBSS 內的對等站 (臨機操作網路) 將 ESS 子欄位設定為 0，並將傳輸指標或探查回應框架中的 IBSS 子字段設定為 1。
CF-Pollable
位2
 值，指出AP或對等站是否可輪詢。
CF 輪詢要求
位3
 值，指出AP或對等站如何處理輪詢要求。
隱私權
位 4
 值，指出所有數據框架是否需要加密。

如果 BSS 內交換的所有數據類型框架都需要 WEP、WPA 或 WPA2 加密，AP 會將 [隱私權] 子欄位設定為傳輸的指標和探查回應框架內的 1。 如果不需要 WEP、WPA 或 WPA2 加密，則 Privacy 子字段會設定為 0。

如果 WEP、WPA 或 WPA2 加密需要 WEP、WPA 或 WPA2 加密，則 IBSS 內交換的所有數據類型框架都需要隱私權子字位為 1。 如果不需要 WEP、WPA 或 WPA2 加密，則 Privacy 子字段會設定為 0。

ulChCenterFrequency

收到802.11指標或探查響應畫面的訊號範圍中心頻率。 ulChCenterFrequency 的值為 kbhertz (kHz) 。

注意 這個成員僅適用於非頻率跳動散佈範圍 (FHSS) 的 PHY 類型。
 

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

另請參閱

WLAN_AVAILABLE_NETWORK

WLAN_AVAILABLE_NETWORK_LIST

WLAN_BSS_LIST

WlanGetAvailableNetworkList

WlanGetNetworkBssList