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

Importante A interface lan sem fio Native 802.11 foi preterida em Windows 10 e posteriores. Em vez disso, use a WDI (Interface do Driver de Dispositivo) WLAN. Para obter mais informações sobre o WDI, consulte WLAN Modelo de driver Universal do Windows.

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 Manipulador IHV Dot11ExtIhvInitAdapter .

[in] dwUnicastCipherAlgo

Um DOT11_CIPHER_ALGORITHM valor de enumerador que identifica o algoritmo de codificação 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 com suporte do adaptador WLAN.

Caso contrário, a DLL é responsável por processar um algoritmo de criptografia padrão com suporte do sistema operacional. Nessa situação, o sistema operacional não está envolvido em 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ásica por meio do adaptador WLAN.

Nota O valor de dwUnicastCipherAlgo deve corresponder ao valor de um algoritmo de codificação retornado pelo driver de miniporto Native 802.11 por meio da configuração dos membros xxx AlgoPairs 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