DOT11EXT_SET_KEY_MAPPING_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 Dot11ExtSetKeyMappingKey para adicionar ou excluir uma chave de criptografia das tabelas de chaves de mapeamento de chave 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_KEY_MAPPING_KEY Dot11extSetKeyMappingKey;

DWORD Dot11extSetKeyMappingKey(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           PDOT11_CIPHER_KEY_MAPPING_KEY_VALUE pKey
)
{...}

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_KEY_MAPPING_KEY_VALUE estrutura, que define a chave de criptografia.

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 chave de codificação de mapeamento de chave será excluída das tabelas de chave do adaptador se o bDelete membro do DOT11_CIPHER_KEY_MAPPING_KEY_VALUE estrutura é definida como verdadeiro.

Uma chamada para a função Dot11ExtSetKeyMappingKey resulta em uma solicitação definida do OID_DOT11_CIPHER_KEY_MAPPING_KEY 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_KEY_MAPPING_KEY

tipos de chave de criptografia 802.11

DOT11_CIPHER_KEY_MAPPING_KEY_VALUE

Dot11ExtIhvInitAdapter

Compartilhar via