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

Artigo
05/23/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 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 de pela 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 manipulador IHV Dot11ExtIhvInitAdapter .

[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.

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.

Comentários

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 compatíveis com o 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 é chamada, o sistema operacional envia um pacote EAP sobre LAN (EAPOL) Start 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á o Dot11ExtIhvOneXIndicateResult Função 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 estas 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 IHV Handler, 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.

Nota A DLL de Extensões IHV é responsável pelo processamento EAPOL-Key pacotes 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 Dot11ExtIhvOneXIndicateResult Função manipulador 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
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)