estrutura WLAN_AVAILABLE_NETWORK (wlanapi.h)

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 .

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.

dwReserved

Reservado para uso futuro. Deve ser definido como NULL.

Requisitos

Confira também

WLAN_AVAILABLE_NETWORK_LIST