DOT11EXT_SET_DEFAULT_KEY 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 Dot11ExtSetDefaultKey para adicionar ou excluir uma chave de criptografia das tabelas de chave padrão ou de chave padrão por estação do adaptador WLAN (LAN sem fio). Para obter mais informações sobre esses tipos de chave, consulte tipos de chave de criptografia 802.11.

Sintaxe

DOT11EXT_SET_DEFAULT_KEY Dot11extSetDefaultKey;

DWORD Dot11extSetDefaultKey(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           PDOT11_CIPHER_DEFAULT_KEY_VALUE pKey,
  [in]           DOT11_DIRECTION dot11Direction
)
{...}

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] pKey

Um ponteiro para um DOT11_CIPHER_DEFAULT_KEY_VALUE estrutura, que define a chave de criptografia.

[in] dot11Direction

Um valor DOT11_DIRECTION que especifica se a chave pode ser usada apenas para pacotes recebidos (DOT11_DIR_INBOUND) ou pacotes recebidos e enviados (DOT11_DIR_BOTH).

Observação A DLL de Extensões IHV não deve passar um valor de DOT11_DIR_OUTBOUND para esse parâmetro.

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

Uma chamada para a função Dot11ExtSetDefaultKey resulta em uma solicitação definida do OID_DOT11_CIPHER_DEFAULT_KEY identificador de objeto para o adaptador WLAN.

Uma chave de codificação padrão é definida definindo o macAddr membro do DOT11_CIPHER_DEFAULT_KEY_VALUE estrutura para um valor de 0x000000000000. Uma chave de criptografia padrão por estação é definida definindo o macAddr membro para um endereço MAC (controle de acesso de mídia unicast) válido.

Uma chave de criptografia será excluída das tabelas de chave do adaptador se o bDelete membro do DOT11_CIPHER_DEFAULT_KEY_VALUE estrutura está definida como TRUE.

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)