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

Artigo
03/01/2024

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

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 Manipulador IHV Dot11ExtIhvInitAdapter .

[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 só pode ser usada para pacotes recebidos (DOT11_DIR_INBOUND) ou pacotes recebidos e enviados (DOT11_DIR_BOTH).

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

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

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 criptografia padrão é definida definindo o membro MacAddr do DOT11_CIPHER_DEFAULT_KEY_VALUE estrutura para um valor de 0x000000000000. Uma chave de criptografia padrão por estação é definida definindo o membro MacAddr como um endereço MAC (controle de acesso de mídia unicast) válido.

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

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)