DOT11EXT_PROCESS_ONEX_PACKET Rückruffunktion (wlanihv.h)

Wichtige Die Native 802.11 Wireless LAN--Schnittstelle ist in Windows 10 und höher veraltet. Verwenden Sie stattdessen die WLAN Device Driver Interface (WDI). Weitere Informationen zu WDI finden Sie unter WLAN Universal Windows driver model.

 

Die IHV Extensions DLL ruft die Dot11ExtProcessOneXPacket Funktion auf, um EAP über LAN (EAPOL)-Pakete während eines 802.1X-Authentifizierungsvorgangs mit dem Zugriffspunkt (AP) an das Betriebssystem weiterzuleiten.

Syntax

DOT11EXT_PROCESS_ONEX_PACKET Dot11extProcessOnexPacket;

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

Parameter

[in, optional] hDot11SvcHandle

Das Handle, das vom Betriebssystem verwendet wird, um auf den WLAN-Adapter (Wireless LAN) zu verweisen. Dieser Handlewert wurde über einen vorherigen Aufruf der Dot11ExtIhvInitAdapter IHV-Handlerfunktion angegeben.

[in] dwInPacketSize

Die Länge der Paketdaten innerhalb des Puffers, auf die vom pvInPacket Parameter verwiesen wird.

[in] pvInPacket

Das EAPOL-Paket, das von der AP empfangen wurde. Der pvInPacket Parameter muss auf das EAPOL-Paket verweisen, beginnend mit dem Pakettypfeld in der EAPOL-Protokolldateneinheit (PDU). Weitere Informationen zum EAPOL-Pakettypfeld finden Sie in Klausel 7.5.4 im IEEE 802.1X-2001-Standard.

Rückgabewert

Wenn der Aufruf erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück. Andernfalls wird ein fehlercode zurückgegeben, der in Winerror.h definiert ist.

Bemerkungen

Wenn sie die Dot11ExtStartOneX--Funktion aufruft, initiiert die IHV-Erweiterungs-DLL einen 802.1X-Authentifizierungsvorgang mithilfe des 802.1X-Moduls des Native 802.11-Frameworks. Dadurch kann die DLL die standardmäßigen EAP-Algorithmen (Extensible Authentication Protocol) verwenden, die vom Betriebssystem unterstützt werden.

Während der 802.1X-Authentifizierungsvorgang aussteht, leitet die IHV-Erweiterungs-DLL EAP-Pakete über LAN (EAPOL) über einen Aufruf der Dot11ExtProcessOneXPacket--Funktion an das Betriebssystem weiter. Die IHV Extensions DLL empfängt diese Pakete über die Dot11ExtIhvReceivePacket IHV-Handlerfunktion.

Hinweis Die IHV Extensions DLL ist für die Verarbeitung EAPOL-Key Pakete verantwortlich und darf diese nicht an das Betriebssystem weiterleiten.

 

Weitere Informationen zu EAPOL-Paketen finden Sie in Klausel 7 des IEEE 802.1X-2001-Standards.

Weitere Informationen zur Verwendung des 802.1X-Moduls für die Authentifizierung finden Sie unter Interface to the Native 802.11 802.1X Module

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform-	Desktop
Header-	wlanihv.h (inklusive Wlanihv.h)

Siehe auch

Dot11ExtIhvReceivePacket

Dot11ExtIhvInitAdapter

Dot11ExtIhvOneXIndicateResult

Dot11ExtStartOneX-

Dot11ExtStopOneX-