estructura WLAN_AVAILABLE_NETWORK (wlanapi.h)

La estructura WLAN_AVAILABLE_NETWORK contiene información sobre una red inalámbrica disponible.

Sintaxis

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;

Miembros

strProfileName[WLAN_MAX_NAME_LENGTH]

Contiene el nombre del perfil asociado a la red. Si la red no tiene un perfil, este miembro estará vacío. Si hay varios perfiles asociados a la red, habrá varias entradas con el mismo SSID en la lista de red visible. Los nombres de perfil distinguen mayúsculas de minúsculas. Esta cadena debe terminar en NULL.

dot11Ssid

Estructura DOT11_SSID que contiene el SSID de la red inalámbrica visible.

dot11BssType

Valor DOT11_BSS_TYPE que especifica si la red es infraestructura o ad hoc.

uNumberOfBssids

Indica el número de BSSID en la red.

Windows XP con SP3 y la API de LAN inalámbrica para Windows XP con SP2: uNumberofBssids es como máximo 1, independientemente del número de puntos de acceso que difunden el SSID.

bNetworkConnectable

Indica si la red es conectable o no. Si se establece en TRUE, la red se puede conectar; de lo contrario, la red no se puede conectar.

wlanNotConnectableReason

Valor WLAN_REASON_CODE que indica por qué no se puede conectar una red. Este miembro solo es válido cuando bNetworkConnectable es FALSE.

uNumberOfPhyTypes

El número de tipos PHY admitidos en redes disponibles. El valor máximo de uNumberOfPhyTypes es WLAN_MAX_PHY_TYPE_NUMBER, que tiene un valor de 8. Si se admiten más de WLAN_MAX_PHY_TYPE_NUMBER tipos PHY, bMorePhyTypes debe establecerse en TRUE.

dot11PhyTypes[WLAN_MAX_PHY_TYPE_NUMBER]

Contiene una matriz de valores de DOT11_PHY_TYPE que representan los tipos PHY admitidos por las redes disponibles. Cuando uNumberOfPhyTypes es mayor que WLAN_MAX_PHY_TYPE_NUMBER, esta matriz contiene solo los primeros tipos WLAN_MAX_PHY_TYPE_NUMBER PHY.

bMorePhyTypes

Especifica si hay más de WLAN_MAX_PHY_TYPE_NUMBER tipos PHY admitidos.

Cuando este miembro se establece en TRUE, una aplicación debe llamar a WlanGetNetworkBssList para obtener la lista completa de tipos PHY. La estructura de WLAN_BSS_LIST devuelta tiene una matriz de estructuras WLAN_BSS_ENTRY . El miembro uPhyId de la estructura WLAN_BSS_ENTRY contiene el tipo PHY de una entrada.

wlanSignalQuality

Valor porcentual que representa la calidad de señal de la red. WLAN_SIGNAL_QUALITY es de tipo ULONG. Este miembro contiene un valor entre 0 y 100. Un valor de 0 implica una intensidad de señal RSSI real de -100 dbm. Un valor de 100 implica una intensidad de señal RSSI real de -50 dbm. Puede calcular el valor de intensidad de señal RSSI para los valores wlanSignalQuality entre 1 y 99 mediante la interpolación lineal.

bSecurityEnabled

Indica si la seguridad está habilitada en la red. Un valor true indica que la seguridad está habilitada; de lo contrario, no lo es.

dot11DefaultAuthAlgorithm

Valor de DOT11_AUTH_ALGORITHM que indica el algoritmo de autenticación predeterminado que se usa para unirse a esta red por primera vez.

dot11DefaultCipherAlgorithm

Valor DOT11_CIPHER_ALGORITHM que indica el algoritmo de cifrado predeterminado que se va a usar al unir esta red.

dwFlags

Contiene varias marcas para la red.

dwReserved

Reservado para uso futuro. Debe establecerse en NULL.

Requisitos

Consulte también

WLAN_AVAILABLE_NETWORK_LIST