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

Artigo
03/01/2024

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 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 referenciar o adaptador WLAN. Esse valor de identificador foi especificado por meio de uma chamada anterior para a função manipulador IHV Dot11ExtIhvInitAdapter .

[in] dwMulticastCipherAlgo

Um DOT11_CIPHER_ALGORITHM valor de enumerador 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 com suporte pelo adaptador WLAN.

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

Nota 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 dos membros xxxAlgoPairs apropriados 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.

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.

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

DOT11_CIPHER_ALGORITHM

Dot11ExtIhvInitAdapter

Compartilhar via