Compartilhar via


DOT11EXT_SET_DEFAULT_KEY_ID função de retorno de chamada (wlanihv.h)

Importante A interface lan sem fio Native 802.11 foi preterida em Windows 10 e posteriores. Em vez disso, use a WDI (Interface do Driver de Dispositivo) WLAN. Para obter mais informações sobre o WDI, consulte WLAN Modelo de driver Universal do Windows.
 
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 WLAN (LAN sem fio) 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 Manipulador IHV Dot11ExtIhvInitAdapter .

[in] uDefaultKeyId

O valor de índice da chave dentro das tabelas de chave de codificação 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.

Retornar valor

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.

Comentários

O ID (identificador de chave) padrão especifica o índice de uma chave de criptografia na chave padrão do adaptador e nas 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 802.11 Tipos de chave de criptografia.

Uma chamada para a função Dot11ExtSetDefaultKeyId 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
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho wlanihv.h (inclua Wlanihv.h)

Confira também

OID_DOT11_CIPHER_DEFAULT_KEY_ID

Dot11ExtIhvInitAdapter

802.11 Tipos de chave de criptografia