DOT11EXT_SET_DEFAULT_KEY_ID função de retorno de chamada (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 DLL de Extensões IHV chama a função Dot11ExtSetDefaultKeyId para definir o índice de tabela da chave de criptografia padrão ou por estação com a qual o adaptador lan sem fio (WLAN) usa por padrão ao criptografar dados de pacote transmitidos.

Sintaxe

DOT11EXT_SET_DEFAULT_KEY_ID Dot11extSetDefaultKeyId;

DWORD Dot11extSetDefaultKeyId(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uDefaultKeyId
)
{...}

Parâmetros

[in, optional] hDot11SvcHandle

O identificador usado pelo sistema operacional para fazer referência ao adaptador WLAN. Esse valor de identificador foi especificado por meio de uma chamada anterior para a função Dot11ExtIhvInitAdapter manipulador IHV.

[in] uDefaultKeyId

O valor de índice da chave dentro das tabelas de chave codificada padrão ou por estação do adaptador.

Para algoritmos de criptografia padrão 802.11, como WEP ou TKIP, uDefaultKeyId deve ser de 0 a 3. Para um algoritmo de criptografia proprietário desenvolvido por um IHV, uDefaultKeyId pode ser qualquer valor dentro do intervalo definido pelo IHV.

Valor de retorno

Se a chamada for bem-sucedida, a função retornará ERROR_SUCCESS. Caso contrário, ele retornará um código de erro definido em Winerror.h.

Observações

O identificador de chave padrão (ID) especifica o índice de uma chave de criptografia na chave padrão do adaptador e tabelas de chaves padrão por estação que o adaptador usa para criptografia de dados. O adaptador usa a chave de criptografia referenciada pela ID de chave padrão como a chave de criptografia padrão para pacotes transmitidos, a menos que exista uma chave de mapeamento de chave para o endereço MAC (controle de acesso à mídia de destino). Para obter mais informações sobre esses tipos de chave de criptografia, consulte tipos de chave de criptografia 802.11.

Uma chamada para a função Dot11ExtSetDefaultKey Id resulta em uma solicitação definida do OID_DOT11_CIPHER_DEFAULT_KEY_ID OID (identificador de objeto) para o driver de miniporto Nativo 802.11, que gerencia o adaptador WLAN.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
da Plataforma de Destino	Área de trabalho
cabeçalho	wlanihv.h (inclua Wlanihv.h)

Consulte também

OID_DOT11_CIPHER_DEFAULT_KEY_ID

Dot11ExtIhvInitAdapter

tipos de chave de criptografia 802.11

Partilhar via