DOT11EXT_SET_UNICAST_CIPHER_ALGORITHM 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 Dot11ExtSetUnicastCipherAlgorithm para habilitar um algoritmo de criptografia unicast no adaptador WLAN (LAN sem fio).

Sintaxe

DOT11EXT_SET_UNICAST_CIPHER_ALGORITHM Dot11extSetUnicastCipherAlgorithm;

DWORD Dot11extSetUnicastCipherAlgorithm(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           DWORD dwUnicastCipherAlgo
)
{...}

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

Um valor de enumerador DOT11_CIPHER_ALGORITHM que identifica o algoritmo de criptografia unicast.

Se o valor estiver dentro do intervalo de DOT11_CIPHER_ALGO_IHV_START até DOT11_CIPHER_ALGO_IHV_END, a DLL de Extensões IHV habilitará um algoritmo de criptografia proprietário compatível com o adaptador WLAN.

Caso contrário, a DLL é responsável pelo processamento de um algoritmo de criptografia padrão com suporte pelo sistema operacional. Nessa situação, o sistema operacional não está envolvido com nenhum aspecto do algoritmo de criptografia, incluindo o gerenciamento de chaves e a proteção de reprodução, em uma conexão de rede BSS (conjunto de serviços básico) por meio do adaptador WLAN.

Observação O valor de dwUnicastCipherAlgo deve corresponder ao valor de um algoritmo de criptografia retornado pelo driver de miniporto Native 802.11 por meio da configuração dos membrosAlgoPairs xxx apropriados da estrutura de DOT11_EXTSTA_ATTRIBUTES, que devem corresponder aos valores que seriam retornados por consultas de OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR ou OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR.

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.

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_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_CIPHER_ALGORITHM

Dot11ExtIhvInitAdapter

Partilhar via