estrutura DOT11EXT_VIRTUAL_STATION_AP_PROPERTY (wlanihv.h)

Artigo
02/07/2025

Importante A interface de lan sem fio do Nativo 802.11 é preterida no Windows 10 e posterior. Em vez disso, use a WDI (Interface de Driver de Dispositivo) WLAN. Para obter mais informações sobre o WDI, consulte do modelo de driver Universal do Windows da WLAN.

A estrutura DOT11EXT_VIRTUAL_STATION_AP_PROPERTY especifica as propriedades de um AP (ponto de acesso) hospedado em uma estação virtual 802.11.

Sintaxe

typedef struct _DOT11EXT_VIRTUAL_STATION_AP_PROPERTY {
  DOT11_SSID             dot11SSID;
  DOT11_AUTH_ALGORITHM   dot11AuthAlgo;
  DOT11_CIPHER_ALGORITHM dot11CipherAlgo;
  BOOL                   bIsPassPhrase;
  DWORD                  dwKeyLength;
  UCHAR                  ucKeyData[DOT11EXT_PSK_MAX_LENGTH];
} DOT11EXT_VIRTUAL_STATION_AP_PROPERTY, *PDOT11EXT_VIRTUAL_STATION_AP_PROPERTY;

Membros

dot11SSID

Uma estrutura DOT11_SSID que contém o SSID (identificador do conjunto de serviços) usado pela AP da estação virtual.

dot11AuthAlgo

Uma estrutura DOT11_AUTH_ALGORITHM que contém o algoritmo de autenticação usado pela AP da estação virtual.

dot11CipherAlgo

Uma estrutura DOT11_CIPHER_ALGORITHM que contém o algoritmo de criptografia usado pela AP da estação virtual.

bIsPassPhrase

Um valor booliano que indica como o sistema operacional deve interpretar o valor do ucKeyData membro. Para obter mais informações, consulte a seção Comentários a seguir.

dwKeyLength

O comprimento, em bytes, da parte útil do membro ucKeyData. Para obter mais informações, consulte a seção Comentários a seguir.

ucKeyData[DOT11EXT_PSK_MAX_LENGTH]

Um valor UCHAR que especifica a chave usada pelo algoritmo de autenticação PSK (Chaves Pré-compartilhadas) da ap da estação virtual. Para obter mais informações, consulte a seção Comentários a seguir.

Observações

O sistema operacional usa a seguinte lógica para interpretar o valor do membro ucKeyData:

Se bIsPassPhrase = FALSE,
- Se dwKeyLength = 32, ucKeyData será interpretado como dados binários.
- Se dwKeyLength = 64, ucKeyData será interpretado como 32 valores hexadecimal.
- Se dwKeyLength não for igual a 32 ou 64, o sistema operacional ignorará a chamada e retornará um erro.
Se bIsPassPhrase = TRUE, ucKeyData será interpretado como uma frase de passagem e o buffer deverá ser encerrado null. Nesse caso, dwKeyLength deve ter um valor igual a 1 mais o comprimento da cadeia de caracteres de chave.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows 7 e versões posteriores dos sistemas operacionais Windows.
cabeçalho	wlanihv.h (inclua Wlanihv.h)

Consulte também

DOT11_AUTH_ALGORITHM

DOT11_CIPHER_ALGORITHM

DOT11_SSID

Compartilhar via