Compartilhar via


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

Importante A interface lan sem fio Native 802.11 foi preterida no Windows 10 e posterior. Em vez disso, use a WDI (Interface de Driver de Dispositivo) da WLAN. Para obter mais informações sobre o WDI, consulte 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 802.11 Tipos de chave de criptografia.

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

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

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
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_KEY_MAPPING_KEY

802.11 Tipos de chave de criptografia

DOT11_CIPHER_KEY_MAPPING_KEY_VALUE

Dot11ExtIhvInitAdapter