DOT11EXT_PROCESS_ONEX_PACKET Rückruffunktion (wlanihv.h)

Wichtig Die native WLAN-Schnittstelle 802.11 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 DLL für IHV-Erweiterungen ruft die Dot11ExtProcessOneXPacket-Funktion auf, um EAP-over-LAN-Pakete (EAPOL) zur Verarbeitung während eines 802.1X-Authentifizierungsvorgangs mit dem Zugriffspunkt (Access Point, AP) 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 durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter angegeben.

[in] dwInPacketSize

Die Länge der Paketdaten in Bytes innerhalb des Puffers, auf den der parameter pvInPacket verweist.

[in] pvInPacket

Das EAPOL-Paket, das vom AP empfangen wurde. Der Parameter pvInPacket muss auf das EAPOL-Paket verweisen, beginnend mit dem Feld "Pakettyp" in der EAPOL-Protokolldateneinheit (PDU). Weitere Informationen zum Feld EAPOL-Pakettyp finden Sie unter 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 in Winerror.h definierter Fehlercode zurückgegeben.

Hinweise

Wenn die Dot11ExtStartOneX-Funktion aufgerufen wird, initiiert die DLL für IHV-Erweiterungen einen 802.1X-Authentifizierungsvorgang mithilfe des Moduls 802.1X des nativen Frameworks 802.11. 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 DLL für IHV-Erweiterungen empfangene EAP-über-LAN-Pakete (EAPOL) über einen Aufruf der Dot11ExtProcessOneXPacket-Funktion an das Betriebssystem weiter. Die DLL für IHV-Erweiterungen empfängt diese Pakete über die IHV-Handlerfunktion Dot11ExtIhvReceivePacket .

Hinweis Die DLL für IHV-Erweiterungen 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 Moduls 802.1X für die Authentifizierung finden Sie unter Schnittstelle zum nativen 802.11 802.1X-Modul.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	wlanihv.h (wlanihv.h einschließen)

Weitere Informationen

Dot11ExtIhvReceivePacket

Dot11ExtIhvInitAdapter

Dot11ExtIhvOneXIndicateResult

Dot11ExtStartOneX

Dot11ExtStopOneX