DOT11EXT_SET_AUTH_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 Dot11ExtSetAuthAlgorithm para habilitar um algoritmo de autenticação no adaptador WLAN (LAN sem fio).

Sintaxe

DOT11EXT_SET_AUTH_ALGORITHM Dot11extSetAuthAlgorithm;

DWORD Dot11extSetAuthAlgorithm(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           DWORD dwAuthAlgo
)
{...}

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

Um valor DOT11_AUTH_ALGORITHM enumerador que identifica o algoritmo de autenticação.

Se o valor estiver dentro do intervalo de DOT11_AUTH_ALGO_IHV_START até DOT11_AUTH_ALGO_IHV_END, a DLL de Extensões IHV habilitará um algoritmo de autenticação proprietário compatível com o adaptador WLAN.

Caso contrário, a DLL é responsável pelo processamento de um algoritmo de autenticação padrão compatível com o sistema operacional. Nessa situação, o sistema operacional não está envolvido com o processamento de autenticação em uma conexão de rede BSS (conjunto de serviços) básico por meio do adaptador WLAN.

Observação O valor de dwAuthAlgo deve corresponder ao valor de um algoritmo de autenticação retornado pelo driver de miniporto Native 802.11 por meio da configuração do xxxalgoPairs membros da estrutura DOT11_EXTSTA_ATTRIBUTES, que deve 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_MULTICAST_ALGORITHM_PAIR

DOT11_AUTH_ALGORITHM

Dot11ExtIhvInitAdapter

Dot11ExtPreAssociateCompletion OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR

Compartilhar via