DOT11EXT_SET_MULTICAST_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 Dot11ExtSetMulticastCipherAlgorithm para habilitar um algoritmo de criptografia multicast no adaptador WLAN (LAN sem fio).

Sintaxe

DOT11EXT_SET_MULTICAST_CIPHER_ALGORITHM Dot11extSetMulticastCipherAlgorithm;

DWORD Dot11extSetMulticastCipherAlgorithm(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           DWORD dwMulticastCipherAlgo
)
{...}

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

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

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 dwMulticastCipherAlgo deve corresponder ao valor de um algoritmo de criptografia retornado pelo driver de miniporto Native 802.11 por meio da configuração do xxxalgopairs membros da estrutura 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