共用方式為

WLAN_AVAILABLE_NETWORK 結構 (wlanapi.h)

  • 發行項

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

指出網路中 BSSID 的數目。

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) baseband 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
 指定用來定義獨立硬體廠商所開發之 PHY 類型 (IHV) 的範圍開頭。
dot11_phy_type_IHV_end
 指定範圍結尾，這個範圍用來定義獨立硬體廠商所開發的 PHY 類型， (IHV) 。

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。 您可以使用線性插補來計算 wlanSignalQuality 值介於 1 到 99 之間的 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
可轉散發套件 適用於 Windows XP 與 SP2 的無線 LAN API

另請參閱

WLAN_AVAILABLE_NETWORK_LIST