структура WLAN_AVAILABLE_NETWORK (wlanapi.h)

Статья
08/28/2023

Структура 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

Структура DOT11_SSID , содержащая SSID видимой беспроводной сети.

dot11BssType

Значение DOT11_BSS_TYPE , указывающее, является ли сеть инфраструктурной или нерегламентированной.

uNumberOfBssids

Указывает количество идентификаторов BSSID в сети.

Windows XP с пакетом обновления 3 (SP3) и API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2): 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	Задает PHY с прыжками частоты спред-спектром (FHSS). Устройства Bluetooth могут использовать FHSS или адаптацию FHSS.
dot11_phy_type_dsss	Задает PHY спред-спектр прямой последовательности (DSSS).
dot11_phy_type_irbaseband	Указывает PHY базовой полосы инфракрасного (IR).
dot11_phy_type_ofdm	Задает ортогональное мультиплексирование деления частоты (OFDM) PHY. Устройства 802.11a могут использовать OFDM.
dot11_phy_type_hrdsss	Указывает высокопроизводительный PHY DSSS (HRDSSS).
dot11_phy_type_erp	Указывает расширенную ставку PHY (ERP). Устройства 802.11g могут использовать ERP.
dot11_phy_type_ht	Указывает тип PHY 802.11n.
dot11_phy_type_vht	Указывает тип PHY 802.11ac. Это тип PHY с очень высокой пропускной способностью, указанный в IEEE 802.11ac. Это значение поддерживается в 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 структур. Элемент uPhyId структуры WLAN_BSS_ENTRY содержит тип PHY для записи.

wlanSignalQuality

Процентное значение, представляющее качество сигнала сети. WLAN_SIGNAL_QUALITY имеет тип ULONG. Этот элемент содержит значение от 0 до 100. Значение 0 подразумевает фактическую мощность сигнала RSSI в размере -100 dbm. Значение 100 подразумевает фактическую силу сигнала RSSI в размере -50 dbm. Значение силы сигнала RSSI для значений wlanSignalQuality от 1 до 99 можно вычислить с помощью линейной интерполяции.

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 с пакетом обновления 3 (SP3) [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Верхняя часть	wlanapi.h
Распространяемые компоненты	API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2)

См. также раздел

WLAN_AVAILABLE_NETWORK_LIST

Поделиться через