DOT11EXT_ONEX_START Rückruffunktion (wlanihv.h)

Artikel
03/01/2024

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 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 nativen 802.11-Frameworks anstelle von der DLL für IHV-Erweiterungen verwaltet.

Syntax

DOT11EXT_ONEX_START Dot11extOnexStart;

DWORD Dot11extOnexStart(
  [in, optional] HANDLE hDot11SvcHandle,
                 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 durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter angegeben.

pEapAttributes

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

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

Die DLL für IHV-Erweiterungen initiiert den 802.1X-Authentifizierungsvorgang, indem die Dot11ExtStartOneX-Funktion aufgerufen wird . 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 Vorgänge nach der Zuordnung.

Wenn die Dot11ExtStartOneX-Funktion aufgerufen wird, sendet das Betriebssystem ein EAPOL-Startpaket (EAP over LAN) an den AP. Wenn der 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 Pakets finden Sie unter Klausel 7.5 und Klausel 8.4.2 des IEEE 802.1X-1999-Standards.

Nachdem der 802.1X-Authentifizierungsvorgang initiiert wurde, muss die DLL für IHV-Erweiterungen 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 IHV-Handlerfunktion Dot11ExtIhvReceivePacket 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 DLL für IHV-Erweiterungen 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 DLL für IHV-Erweiterungen kann den 802.1X-Authentifizierungsvorgang abbrechen, indem Sie Dot11ExtStopOneX aufrufen.

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)