DOT11EXT_ONEX_STOP 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 Dot11ExtStopOneX para cancelar uma operação de autenticação 802.1X com o ponto de acesso (AP). A DLL iniciou a autenticação por meio de uma chamada para a função Dot11ExtStartOneX.

Sintaxe

DOT11EXT_ONEX_STOP Dot11extOnexStop;

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

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.

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

Quando chama a função Dot11ExtStartOneX, a DLL de Extensões IHV inicia 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.

Antes da conclusão da operação de autenticação 802.1X, a DLL de Extensões IHV pode chamar a função Dot11ExtStopOneX para cancelar a operação.

Ao chamar a função Dot11ExtStopOneX, a DLL de Extensões IHV deve seguir essas diretrizes.

Dot11ExtStopOneX só pode ser chamado enquanto uma operação de autenticação 802.1X estiver pendente. A DLL de Extensões IHV inicia a autenticação com a AP chamando Dot11ExtStartOneX. Quando a operação de autenticação 802.1X é concluída, o sistema operacional chama o função Dot11ExtIhvOneXIndicateResult manipulador IHV.
Depois que a DLL de Extensões IHV chama Dot11ExtStopOneX, ela não deve chamar pacotes Dot11ExtProcessOneXPack et para encaminhar pacotes EAP 802.1X via LAN (EAPOL) para o sistema operacional. Para obter mais informações sobre pacotes EAPOL, consulte a Cláusula 7 do padrão IEEE 802.1X-2001.

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)