DOT11EXT_ONEX_START Rückruffunktion (wlanihv.h)

Artikel
02/07/2025

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 Dot11ExtStartOneX--Funktion auf, um einen 802.1X-Authentifizierungsvorgang mit dem Zugriffspunkt (AP) zu initiieren. In diesem Fall wird die Authentifizierung vom 802.1X-Modul des Native 802.11-Frameworks anstelle der IHV-Erweiterungs-DLL verwaltet.

Syntax

DOT11EXT_ONEX_START Dot11extOnexStart;

DWORD Dot11extOnexStart(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] EAP_ATTRIBUTES *pEapAttributes
)
{...}

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, optional] pEapAttributes

Ein Zeiger auf eine EAP_ATTRIBUTES Arraystruktur, die die von der Authentifizierungssitzung zurückgegebenen EAP-Attribute enthält. Weitere Informationen zu EAP_ATTRIBUTES finden Sie in der Microsoft Windows SDK-Dokumentation.

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

Die IHV Extensions DLL kann einen 802.1X-Authentifizierungsvorgang mithilfe des 802.1X-Moduls des Native 802.11-Frameworks initiieren. Dadurch kann die DLL die standardmäßigen EAP-Algorithmen (Extensible Authentication Protocol) verwenden, die vom Betriebssystem unterstützt werden.

Die IHV Extensions DLL initiiert den 802.1X-Authentifizierungsvorgang durch Aufrufen der Dot11ExtStartOneX--Funktion. Dot11ExtStartOneX- kann nur während eines Vorgangs nach der Zuordnung oder nach Abschluss des Vorgangs aufgerufen werden. Weitere Informationen zu diesem Vorgang finden Sie unter Post-Association Operations.

Wenn die Dot11ExtStartOneX--Funktion aufgerufen wird, sendet das Betriebssystem ein EAP über LAN (EAPOL) Startpaket an die AP. Wenn die AP nach drei Übertragungen des EAPOL-Start-Pakets nicht reagiert, schlägt das Betriebssystem den 802.1X-Authentifizierungsvorgang fehl und ruft die Dot11ExtIhvOneXIndicateResult IHV-Handlerfunktion. Weitere Informationen zum EAPOL-Start Paket finden Sie in Abschnitt 7.5 und Klausel 8.4.2 des IEEE 802.1X-1999-Standards.

Nachdem der 802.1X-Authentifizierungsvorgang initiiert wurde, muss die IHV-Erweiterungs-DLL diese Richtlinien befolgen.

Die IHV-Erweiterungen müssen alle EAPOL-Pakete zur Verarbeitung an das Betriebssystem weiterleiten. Wenn die DLL ein EAPOL-Paket über einen Aufruf der Dot11ExtIhvReceivePacket IHV-Handlerfunktion empfängt, muss die DLL Dot11ExtProcessOneXPacket aufrufen, um das Paket an das Betriebssystem weiterzuleiten.
Weitere Informationen zu EAPOL-Paketen finden Sie in Klausel 7 des IEEE 802.1X-2001-Standards.

Hinweis Die IHV Extensions DLL ist für die Verarbeitung EAPOL-Key Pakete verantwortlich und darf diese nicht an das Betriebssystem weiterleiten.
Wenn der 802.1X-Authentifizierungsvorgang abgeschlossen ist, ruft das Betriebssystem die Dot11ExtIhvOneXIndicateResult IHV-Handlerfunktion, um anzugeben, dass die Autorisierung ausgeführt wird.
Die IHV Extensions DLL kann den 802.1X-Authentifizierungsvorgang abbrechen, indem Dot11ExtStopOneX-aufgerufen wird.

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)