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

  • Artigo
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 Dot11ExtProcessOneXPacket para encaminhar pacotes EAP por LAN (EAPOL) para o sistema operacional para processamento durante uma operação de autenticação 802.1X com o ponto de acesso (AP).

Sintaxe

DOT11EXT_PROCESS_ONEX_PACKET Dot11extProcessOnexPacket;

DWORD Dot11extProcessOnexPacket(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           DWORD dwInPacketSize,
  [in]           LPVOID pvInPacket
)
{...}

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

O comprimento, em bytes, dos dados do pacote dentro do buffer referenciado pelo parâmetro pvInPacket .

[in] pvInPacket

O pacote EAPOL recebido da AP. O parâmetro pvInPacket deve referenciar o pacote EAPOL a partir do campo tipo de pacote na PDU (unidade de dados do protocolo EAPOL). Para obter mais informações sobre o campo tipo de pacote EAPOL, consulte a Cláusula 7.5.4 no padrão IEEE 802.1X-2001.

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

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 compatíveis com o sistema operacional.

Embora a operação de autenticação 802.1X esteja pendente, a DLL de Extensões IHV encaminha pacotes EAP por LAN (EAPOL) recebidos para o sistema operacional por meio de uma chamada para a função Dot11ExtProcessOneXPacket . A DLL de Extensões IHV recebe esses pacotes por meio da função manipulador IHV Dot11ExtIhvReceivePacket .

Nota A DLL de Extensões IHV é responsável pelo processamento EAPOL-Key pacotes e não deve encaminhá-los 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
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

Dot11ExtIhvReceivePacket

Dot11ExtIhvInitAdapter

Dot11ExtIhvOneXIndicateResult

Dot11ExtStartOneX

Dot11ExtStopOneX