estructura WLAN_BSS_ENTRY (wlanapi.h)

La estructura WLAN_BSS_ENTRY contiene información sobre un conjunto de servicios básico (BSS).

Sintaxis

typedef struct _WLAN_BSS_ENTRY {
  DOT11_SSID        dot11Ssid;
  ULONG             uPhyId;
  DOT11_MAC_ADDRESS dot11Bssid;
  DOT11_BSS_TYPE    dot11BssType;
  DOT11_PHY_TYPE    dot11BssPhyType;
  LONG              lRssi;
  ULONG             uLinkQuality;
  BOOLEAN           bInRegDomain;
  USHORT            usBeaconPeriod;
  ULONGLONG         ullTimestamp;
  ULONGLONG         ullHostTimestamp;
  USHORT            usCapabilityInformation;
  ULONG             ulChCenterFrequency;
  WLAN_RATE_SET     wlanRateSet;
  ULONG             ulIeOffset;
  ULONG             ulIeSize;
} WLAN_BSS_ENTRY, *PWLAN_BSS_ENTRY;

Miembros

dot11Ssid

SSID del punto de acceso (AP) o de la estación del mismo nivel asociada al BSS. El tipo de datos de este miembro es una estructura DOT11_SSID .

uPhyId

Identificador (ID) de la PHY que la interfaz LAN inalámbrica usó para detectar la red BSS.

dot11Bssid

La dirección del control de acceso multimedia (MAC) del punto de acceso para redes BSS de infraestructura o la estación del mismo nivel para redes BSS independientes (redes ad hoc) que enviaron el marco 802.11 Beacon o Probe Response recibido por la interfaz laN inalámbrica durante el escaneo. El tipo de datos de este miembro es una estructura DOT11_MAC_ADDRESS .

dot11BssType

Tipo de red BSS. El tipo de datos de este miembro es un valor de enumeración DOT11_BSS_TYPE .

Este miembro puede ser uno de los valores siguientes.

Valor	Significado
dot11_BSS_type_infrastructure 1	Especifica una red BSS de infraestructura.
dot11_BSS_type_independent 2	Especifica una red BSS (IBSS) independiente (una red ad hoc).

dot11BssPhyType

Tipo PHY para esta red. El tipo de datos de este miembro es un valor de enumeración DOT11_PHY_TYPE .

lRssi

El valor del indicador de intensidad de señal recibido (RSSI), en unidades de decibelios a los que se hace referencia a 1,0 miliwatts (dBm), tal como lo detecta el controlador de interfaz LAN inalámbrica para la estación AP o del mismo nivel.

uLinkQuality

La calidad del enlace notificada por el controlador de interfaz de LAN inalámbrica. El valor de calidad del vínculo oscila entre 0 y 100. Un valor de 100 especifica la calidad de vínculo más alta.

bInRegDomain

Valor que especifica si la estación ap o del mismo nivel funciona dentro del dominio normativo, tal y como se identifica en el país o región.

Si el controlador de interfaz LAN inalámbrica no admite varios dominios normativos, este miembro se establece en TRUE.

Si el marco 802.11 Beacon o Probe Response recibido de la estación AP o del mismo nivel no incluye un elemento de información de país (IE), este miembro se establece en TRUE.

Si el marco de respuesta de sondeo o baliza 802.11 recibido de la estación AP o del mismo nivel incluye un IE de país, este miembro se establece en FALSE si el valor del subcampo Cadena de país no es igual a la cadena de país de entrada.

usBeaconPeriod

El valor del campo Intervalo de baliza del marco 802.11 Beacon o Probe Response recibido por la interfaz LAN inalámbrica.

El intervalo está en 1024 unidades de tiempo de microsegundos entre tiempos de transmisión de balizas de destino. Esta información se recupera del paquete de baliza enviado por un punto de acceso en una red BSS de infraestructura o una respuesta de sondeo desde un punto de acceso o estación del mismo nivel en respuesta a un cliente LAN inalámbrico que envía una solicitud de sondeo.

El estándar IEEE 802.11 define una unidad de tiempo igual a 1024 microsegundos. Esta unidad se definió para que se pueda implementar fácilmente en hardware.

ullTimestamp

El valor del campo Marca de tiempo del marco 802.11 Beacon o Probe Response recibido por la interfaz LAN inalámbrica.

ullHostTimestamp

Valor de marca de tiempo del host que registra cuando la interfaz LAN inalámbrica recibió el marco de respuesta de baliza o sondeo. Este miembro es un recuento de intervalos de 100 nanosegundos desde el 1 de enero de 1601.

Para obtener más información, vea la función NdisGetCurrentSystemTime documentada en WDK.

usCapabilityInformation

El valor del campo Información de funcionalidad del marco 802.11 Beacon o Probe Response recibido por la interfaz LAN inalámbrica. Este valor es un conjunto de marcas de bits que definen la funcionalidad.

Este miembro puede ser uno o varios de los valores siguientes.

Valor	Significado
ESS bit 0	Un conjunto de servicios extendidos. Un conjunto de uno o varios conjuntos de servicios básicos interconectados (BSS) y redes de área local integradas (LAN) que aparecen como un único BSS en la capa de control de vínculo lógico en cualquier estación asociada a uno de esos BSS. Un AP establece el subcampo ESS en 1 y el subcampo IBSS en 0 en marcos de respuesta de baliza o sondeo transmitidos. Una estación del mismo nivel dentro de un IBSS (red ad hoc) establece el subcampo ESS en 0 y el subcampo IBSS en 1 en marcos de respuesta de sondeo o baliza transmitidos.
IBSS bit 1	Un conjunto de servicios básicos independiente. Un BSS que forma una red autocontenida y en la que no hay acceso a un sistema de distribución (DS) está disponible (una red ad hoc). Un AP establece el subcampo ESS en 1 y el subcampo IBSS en 0 dentro de marcos de respuesta de baliza o sondeo transmitidos. Una estación del mismo nivel dentro de un IBSS (red ad hoc) establece el subcampo ESS en 0 y el subcampo IBSS en 1 en marcos de respuesta de sondeo o baliza transmitidos.
CF-Pollable bit 2	Valor que indica si se puede sondear el AP o la estación del mismo nivel.
Solicitud de sondeo de CF bit 3	Valor que indica cómo controla las solicitudes de sondeo el AP o la estación del mismo nivel.
Privacidad bit 4	Valor que indica si se requiere cifrado para todos los fotogramas de datos. Un AP establece el subcampo Privacidad en 1 dentro de marcos de respuesta de baliza y sondeo transmitidos si se requiere el cifrado WEP, WPA o WPA2 para todos los fotogramas de tipo de datos intercambiados dentro del BSS. Si no se requiere el cifrado WEP, WPA o WPA2, el subcampo Privacidad se establece en 0. Una estación del mismo nivel dentro de y IBSS establece el subcampo Privacidad en 1 dentro de marcos de respuesta de baliza y sondeo transmitidos si se requiere el cifrado WEP, WPA o WPA2 para todos los fotogramas de tipo de datos intercambiados dentro del IBSS. Si no se requiere el cifrado WEP, WPA o WPA2, el subcampo Privacidad se establece en 0.

ulChCenterFrequency

Frecuencia del centro del canal de la banda en la que se recibió el marco 802.11 Beacon o Probe Response. El valor de ulChCenterFrequency está en unidades de kilohercios (kHz).

Nota Este miembro solo es válido para los tipos PHY que no son espectro de propagación de frecuencia (FHSS).

 

wlanRateSet

Conjunto de velocidades de transferencia de datos admitidas por el BSS. El tipo de datos de este miembro es una estructura WLAN_RATE_SET .

ulIeOffset

Desplazamiento, en bytes, del blob de datos del elemento de información (IE) desde el principio de la estructura WLAN_BSS_ENTRY .

Este miembro apunta a un búfer que contiene elementos de información de longitud variable (IE) de los fotogramas 802.11 Beacon o Probe Response. Para cada BSS, las IEs proceden del último marco de respuesta de baliza o sondeo recibido de esa red BSS. Si un IE está disponible en un solo fotograma, el controlador de interfaz LAN inalámbrica combina el IE con las otras IE del último fotograma de baliza o respuesta de sondeo recibido.

Los elementos de información se definen en las especificaciones IEEE 802.11 para tener un formato general común formado por un campo id. de elemento de 1 byte, un campo longitud de 1 byte y un campo de información específico del elemento de longitud variable. A cada elemento de información se le asigna un valor de identificador de elemento único tal y como se define en estos estándares IEEE 802.11. El campo Longitud especifica el número de bytes del campo de información.

ulIeSize

Tamaño, en bytes, del blob de datos de IE en la estructura WLAN_BSS_ENTRY .

Esta es la longitud exacta de los datos del búfer al que apunta el miembro ulIeOffset y no contiene ningún relleno para la alineación. El valor máximo del tamaño del blob de datos de IE es de 2324 bytes.

Comentarios

La función WlanGetNetworkBssList recupera la lista BSS de la red inalámbrica o redes en una interfaz determinada y devuelve esta información en una estructura WLAN_BSS_LIST que contiene una matriz de . WLAN_BSS_ENTRY estructuras.

Cuando la interfaz de LAN inalámbrica también funciona como una red hospedada inalámbrica, la lista BSS contendrá una entrada para el BSS creado para la red hospedada inalámbrica.

Dado que el punto de acceso devuelve la información de una red BSS de infraestructura o del mismo nivel de red para una red BSS independiente (red ad hoc), la información devuelta no debe ser de confianza. Los miembros ulIeOffset y ulIeSize de la estructura WLAN_BSS_ENTRY deben usarse para determinar el tamaño máximo del blob de datos del elemento de información en la estructura WLAN_BSS_ENTRY , no los datos del blob de datos del elemento de información.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	wlanapi.h

Consulte también

WLAN_AVAILABLE_NETWORK

WLAN_AVAILABLE_NETWORK_LIST

WLAN_BSS_LIST

WlanGetAvailableNetworkList

WlanGetNetworkBssList