DOT11EXT_ONEX_START 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 Dot11ExtStartOneX para iniciar uma operação de autenticação 802.1X com o ponto de acesso (AP). Nessa situação, a autenticação é gerenciada pelo módulo 802.1X da estrutura Native 802.11 em vez da DLL de Extensões IHV.

Sintaxe

DOT11EXT_ONEX_START Dot11extOnexStart;

DWORD Dot11extOnexStart(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] EAP_ATTRIBUTES *pEapAttributes
)
{...}

Parâmetros

[in, optional] hDot11SvcHandle

O identificador usado pelo sistema operacional para referenciar o adaptador WLAN (LAN sem fio). Esse valor de identificador foi especificado por meio de uma chamada anterior para a função Dot11ExtIhvInitAdapter manipulador IHV.

[in, optional] pEapAttributes

Um ponteiro para uma estrutura de matriz EAP_ATTRIBUTES que contém os atributos EAP retornados pela sessão de autenticação. Para obter mais informações sobre EAP_ATTRIBUTES, consulte a documentação do SDK do Microsoft Windows.

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.

Observações

A DLL de Extensões IHV pode iniciar uma operação de autenticação 802.1X usando o módulo 802.1X da estrutura Native 802.11. Isso permite que a DLL use os algoritmos EAP (protocolo de autenticação extensível) padrão com suporte do sistema operacional.

A DLL de Extensões IHV inicia a operação de autenticação 802.1X chamando a função Dot11ExtStartOneX. Dot11ExtStartOneX só pode ser chamado durante uma operação pós-associação ou após a conclusão da operação. Para obter mais informações sobre essa operação, consulte operações pós-associação.

Quando a função Dot11ExtStartOneX for chamada, o sistema operacional enviará um pacote inicial EAP via LAN (EAPOL) para a AP. Se a AP não responder após três transmissões do pacote EAPOL-Start, o sistema operacional falhará na operação de autenticação 802.1X e chamará a função Dot11ExtIhvOneXIndicateResult manipulador IHV. Para obter mais informações sobre o pacote EAPOL-Start, consulte a Cláusula 7.5 e a Cláusula 8.4.2 do padrão IEEE 802.1X-1999.

Depois que a operação de autenticação 802.1X for iniciada, a DLL de Extensões IHV deverá seguir essas diretrizes.

As Extensões IHV devem encaminhar todos os pacotes EAPOL para o sistema operacional para processamento. Quando a DLL recebe um pacote EAPOL por meio de uma chamada para a função Dot11ExtIhvReceivePacket manipulador IHV, a DLL deve chamar Dot11ExtProcessOneXPacket para encaminhar o pacote para o sistema operacional.
Para obter mais informações sobre pacotes EAPOL, consulte a Cláusula 7 do padrão IEEE 802.1X-2001.

Observação A DLL de Extensões IHV é responsável pelo processamento de pacotes EAPOL-Key e não deve encaminhá-los para o sistema operacional.
Quando a operação de autenticação 802.1X é concluída, o sistema operacional chama o função Dot11ExtIhvOneXIndicateResult manipulador de IHV para indicar que a autorização está em andamento.
A DLL de Extensões IHV pode cancelar a operação de autenticação 802.1X chamando Dot11ExtStopOneX.

Para obter mais informações sobre como usar o módulo 802.1X para autenticação, consulte Interface para o Módulo Nativo 802.11 802.1X.

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)