estrutura WLAN_AVAILABLE_NETWORK (wlanapi.h)

Artigo
08/28/2023

A estrutura WLAN_AVAILABLE_NETWORK contém informações sobre uma rede sem fio disponível.

Sintaxe

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;

Membros

strProfileName[WLAN_MAX_NAME_LENGTH]

Contém o nome do perfil associado à rede. Se a rede não tiver um perfil, esse membro estará vazio. Se vários perfis estiverem associados à rede, haverá várias entradas com o mesmo SSID na lista de rede visível. Os nomes de perfil diferenciam maiúsculas de minúsculas. Essa cadeia de caracteres deve ser terminada em NULL.

dot11Ssid

Uma estrutura DOT11_SSID que contém o SSID da rede sem fio visível.

dot11BssType

Um valor DOT11_BSS_TYPE que especifica se a rede é infraestrutura ou ad hoc.

uNumberOfBssids

Indica o número de BSSIDs na rede.

Windows XP com SP3 e API lan sem fio para Windows XP com SP2: uNumberofBssids é no máximo 1, independentemente do número de pontos de acesso que transmitem o SSID.

bNetworkConnectable

Indica se a rede é conectável ou não. Se definida como TRUE, a rede será conectável, caso contrário, a rede não poderá ser conectada.

wlanNotConnectableReason

Um valor WLAN_REASON_CODE que indica por que uma rede não pode ser conectada. Esse membro só é válido quando bNetworkConnectable é FALSE.

uNumberOfPhyTypes

O número de tipos de PHY com suporte em redes disponíveis. O valor máximo de uNumberOfPhyTypes é WLAN_MAX_PHY_TYPE_NUMBER, que tem um valor de 8. Se houver mais de WLAN_MAX_PHY_TYPE_NUMBER tipos de PHY, bMorePhyTypes deverá ser definido como TRUE.

dot11PhyTypes[WLAN_MAX_PHY_TYPE_NUMBER]

Contém uma matriz de valores DOT11_PHY_TYPE que representam os tipos de PHY compatíveis com as redes disponíveis. Quando uNumberOfPhyTypes é maior que WLAN_MAX_PHY_TYPE_NUMBER, essa matriz contém apenas os primeiros tipos de PHY WLAN_MAX_PHY_TYPE_NUMBER .

Valor	Significado
dot11_phy_type_unknown	Especifica um tipo de PHY desconhecido ou não inicializado.
dot11_phy_type_any	Especifica qualquer tipo de PHY.
dot11_phy_type_fhss	Especifica um PHY FHSS (espectro de distribuição de frequência). Os dispositivos Bluetooth podem usar FHSS ou uma adaptação do FHSS.
dot11_phy_type_dsss	Especifica um PHY de espectro de distribuição de sequência direta (DSSS).
dot11_phy_type_irbaseband	Especifica um PHY de banda base de infravermelho (IR).
dot11_phy_type_ofdm	Especifica um PHY ofDM (multiplexação de divisão de frequência ortogonal). Os dispositivos 802.11a podem usar OFDM.
dot11_phy_type_hrdsss	Especifica um PHY de DSSS (HRDSSS) de alta taxa.
dot11_phy_type_erp	Especifica um ERP (PHY) de taxa estendida. Os dispositivos de 802,11g podem usar o ERP.
dot11_phy_type_ht	Especifica um tipo PHY de 802,11n.
dot11_phy_type_vht	Especifica o tipo PHY 802.11ac. Esse é o tipo de PHY de taxa de transferência muito alto especificado no IEEE 802.11ac. Esse valor tem suporte em Windows 8.1, Windows Server 2012 R2 e posterior.
dot11_phy_type_IHV_start	Especifica o início do intervalo usado para definir tipos de PHY desenvolvidos por um IHV (fornecedor independente de hardware).
dot11_phy_type_IHV_end	Especifica o final do intervalo usado para definir tipos de PHY desenvolvidos por um IHV (fornecedor independente de hardware).

bMorePhyTypes

Especifica se há mais de WLAN_MAX_PHY_TYPE_NUMBER tipos de PHY com suporte.

Quando esse membro é definido como TRUE, um aplicativo deve chamar WlanGetNetworkBssList para obter a lista completa de tipos de PHY. A estrutura de WLAN_BSS_LIST retornada tem uma matriz de estruturas WLAN_BSS_ENTRY . O membro uPhyId da estrutura WLAN_BSS_ENTRY contém o tipo PHY de uma entrada.

wlanSignalQuality

Um valor percentual que representa a qualidade do sinal da rede. WLAN_SIGNAL_QUALITY é do tipo ULONG. Esse membro contém um valor entre 0 e 100. Um valor de 0 implica uma força de sinal RSSI real de -100 dbm. Um valor de 100 implica uma força de sinal RSSI real de -50 dbm. Você pode calcular o valor de força do sinal RSSI para valores wlanSignalQuality entre 1 e 99 usando interpolação linear.

bSecurityEnabled

Indica se a segurança está habilitada na rede. Um valor true indica que a segurança está habilitada, caso contrário, não está.

dot11DefaultAuthAlgorithm

Um valor DOT11_AUTH_ALGORITHM que indica o algoritmo de autenticação padrão usado para ingressar nessa rede pela primeira vez.

dot11DefaultCipherAlgorithm

Um valor DOT11_CIPHER_ALGORITHM que indica o algoritmo de criptografia padrão a ser usado ao ingressar nessa rede.

dwFlags

Contém vários sinalizadores para a rede.

Valor	Significado
WLAN_AVAILABLE_NETWORK_CONNECTED	No momento, essa rede está conectada.
WLAN_AVAILABLE_NETWORK_HAS_PROFILE	Há um perfil para essa rede.

dwReserved

Reservado para uso futuro. Deve ser definido como NULL.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista, Windows XP com SP3 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	wlanapi.h
Redistribuível	API de LAN sem fio para Windows XP com SP2

Confira também

WLAN_AVAILABLE_NETWORK_LIST

Compartilhar via