DOT11EXT_ONEX_STOP 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 Dot11ExtStopOneX--Funktion auf, um einen 802.1X-Authentifizierungsvorgang mit dem Zugriffspunkt (AP) abzubrechen. Die DLL initiierte die Authentifizierung über einen Aufruf der Dot11ExtStartOneX--Funktion.

Syntax

DOT11EXT_ONEX_STOP Dot11extOnexStop;

DWORD Dot11extOnexStop(
  [in, optional] HANDLE hDot11SvcHandle
)
{...}

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.

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.

Bevor der 802.1X-Authentifizierungsvorgang abgeschlossen ist, kann die IHV-Erweiterungs-DLL die Dot11ExtStopOneX--Funktion aufrufen, um den Vorgang abzubrechen.

Beim Aufrufen der funktion Dot11ExtStopOneX muss die IHV Extensions DLL diese Richtlinien befolgen.

Dot11ExtStopOneX- kann nur aufgerufen werden, während ein 802.1X-Authentifizierungsvorgang aussteht. Die IHV Extensions DLL initiiert die Authentifizierung mit der AP, indem Dot11ExtStartOneXaufgerufen wird. Wenn der 802.1X-Authentifizierungsvorgang abgeschlossen ist, ruft das Betriebssystem die Dot11ExtIhvOneXIndicateResult IHV-Handlerfunktion.
Nachdem die IHV Extensions DLL Dot11ExtStopOneX-aufruft, darf sie nicht Dot11ExtProcessOneXPacket- aufrufen, um 802.1X EAP über LAN (EAPOL)-Pakete an das Betriebssystem weiterzuleiten. 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)