estrutura WLAN_BSS_ENTRY (wlanapi.h)
A estrutura WLAN_BSS_ENTRY contém informações sobre um BSS (conjunto de serviços básico).
Sintaxe
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;
Membros
dot11Ssid
O SSID do ponto de acesso (AP) ou da estação par associada ao BSS. O tipo de dados desse membro é uma estrutura DOT11_SSID .
uPhyId
O identificador (ID) do PHY que a interface lan sem fio usou para detectar a rede BSS.
dot11Bssid
O endereço MAC (controle de acesso à mídia) do ponto de acesso para redes BSS de infraestrutura ou a estação par para redes BSS independentes (redes ad hoc) que enviaram o quadro 802.11 Beacon ou Probe Response recebido pela interface lan sem fio durante a verificação. O tipo de dados desse membro é uma estrutura DOT11_MAC_ADDRESS .
dot11BssType
O tipo de rede BSS. O tipo de dados desse membro é um valor de enumeração DOT11_BSS_TYPE .
Esse membro pode ser um dos valores a seguir.
| Valor | Significado |
|---|---|
|
Especifica uma rede BSS de infraestrutura. |
|
Especifica uma rede independente do BSS (IBSS) (uma rede ad hoc). |
dot11BssPhyType
O tipo PHY para essa rede. O tipo de dados desse membro é um valor de enumeração DOT11_PHY_TYPE .
lRssi
O valor RSSI (indicador de força de sinal) recebido, em unidades de decibéis referenciados a 1,0 miliwatts (dBm), conforme detectado pelo driver de interface lan sem fio para a ap ou estação par.
uLinkQuality
A qualidade do link relatada pelo driver de interface lan sem fio. O valor de qualidade do link varia de 0 a 100. Um valor de 100 especifica a mais alta qualidade do link.
bInRegDomain
Um valor que especifica se a AP ou a estação par está operando dentro do domínio regulatório, conforme identificado pelo país/região.
Se o driver de interface lan sem fio não oferecer suporte a vários domínios regulatórios, esse membro será definido como TRUE.
Se o quadro 802.11 Beacon ou Probe Response recebido da AP ou da estação par não incluir um elemento de informações country (IE), esse membro será definido como TRUE.
Se o quadro 802.11 Beacon ou Probe Response recebido da AP ou da estação par incluir um Country IE, esse membro será definido como FALSE se o valor do subcampo Country String não for igual à cadeia de caracteres de país de entrada.
usBeaconPeriod
O valor do campo Intervalo de Sinalizador do quadro Beacon ou Resposta de Investigação 802.11 recebido pela interface lan sem fio.
O intervalo está em 1.024 unidades de tempo de microssegundos entre os tempos de transmissão do sinalizador de destino. Essas informações são recuperadas do pacote de sinalizador enviado por um ponto de acesso em uma rede BSS de infraestrutura ou uma resposta de investigação de um ponto de acesso ou estação de par em resposta a um cliente lan sem fio enviando uma Solicitação de Investigação.
O padrão IEEE 802.11 define uma unidade de tempo igual a 1.024 microssegundos. Essa unidade foi definida para que pudesse ser facilmente implementada no hardware.
ullTimestamp
O valor do campo Carimbo de data/hora do quadro beacon 802.11 ou resposta de investigação recebido pela interface lan sem fio.
ullHostTimestamp
O valor do carimbo de data/hora do host que registra quando a interface LAN sem fio recebeu o quadro Beacon ou Probe Response. Esse membro é uma contagem de intervalos de 100 nanossegundos desde 1º de janeiro de 1601.
Para obter mais informações, consulte a função NdisGetCurrentSystemTime documentada no WDK.
usCapabilityInformation
O valor do campo Informações de Funcionalidade do quadro beacon 802.11 ou resposta de investigação recebido pela interface lan sem fio. Esse valor é um conjunto de sinalizadores de bits que definem a funcionalidade.
Esse membro pode ser um ou mais dos valores a seguir.
ulChCenterFrequency
A frequência da central de canais da banda na qual o quadro 802.11 Beacon ou Probe Response foi recebido. O valor de ulChCenterFrequency está em unidades de quilohertz (kHz).
wlanRateSet
Um conjunto de taxas de transferência de dados com suporte do BSS. O tipo de dados desse membro é uma estrutura WLAN_RATE_SET .
ulIeOffset
O deslocamento, em bytes, do blob de dados do elemento de informação (IE) desde o início da estrutura WLAN_BSS_ENTRY .
Esse membro aponta para um buffer que contém IEs (elementos de informações de comprimento variável) dos quadros 802.11 Beacon ou Probe Response. Para cada BSS, os IEs são do último quadro beacon ou de resposta de investigação recebido dessa rede BSS. Se um IE estiver disponível em apenas um quadro, o driver de interface lan sem fio mescla o IE com os outros IEs do último quadro beacon ou de resposta de investigação recebido.
Os elementos de informação são definidos nas especificações do IEEE 802.11 para ter um formato geral comum que consiste em um campo de ID de elemento de 1 byte, um campo Length de 1 byte e um campo de informações específicas do elemento de comprimento variável. Cada elemento de informações recebe um valor exclusivo da ID do Elemento, conforme definido neste padrão IEEE 802.11. O campo Comprimento especifica o número de bytes no campo de informações.
ulIeSize
O tamanho, em bytes, do blob de dados do IE na estrutura WLAN_BSS_ENTRY .
Esse é o comprimento exato dos dados no buffer apontado pelo membro ulIeOffset e não contém nenhum preenchimento para alinhamento. O valor máximo para o tamanho do blob de dados do IE é de 2.324 bytes.
Comentários
A função WlanGetNetworkBssList recupera a lista BSS da rede ou redes sem fio em uma determinada interface e retorna essas informações em uma estrutura WLAN_BSS_LIST que contém uma matriz de . WLAN_BSS_ENTRY estruturas.
Quando a interface lan sem fio também estiver operando como uma Rede Hospedada Sem Fio, a lista BSS conterá uma entrada para o BSS criado para a Rede Hospedada Sem Fio.
Como as informações são retornadas pelo ponto de acesso de uma rede BSS de infraestrutura ou pelo par de rede de uma rede BSS independente (rede ad hoc), as informações retornadas não devem ser confiáveis. Os membros ulIeOffset e ulIeSize na estrutura WLAN_BSS_ENTRY devem ser usados para determinar o tamanho máximo do blob de dados do elemento de informações na estrutura WLAN_BSS_ENTRY , não os dados no blob de dados do elemento de informações.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Cabeçalho | wlanapi.h |