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

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 durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter angegeben.

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.

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

Beim Aufrufen der Dot11ExtStopOneX-Funktion muss die DLL für IHV-Erweiterungen diese Richtlinien befolgen.

Dot11ExtStopOneX kann nur aufgerufen werden, während ein 802.1X-Authentifizierungsvorgang aussteht. Die DLL für IHV-Erweiterungen initiiert die Authentifizierung beim AP durch Aufrufen von Dot11ExtStartOneX. Wenn der 802.1X-Authentifizierungsvorgang abgeschlossen ist, ruft das Betriebssystem die Dot11ExtIhvOneXIndicateResult IHV-Handlerfunktion.
Nachdem die DLL für IHV-Erweiterungen Dot11ExtStopOneX aufgerufen hat, darf sie Dot11ExtProcessOneXPacket nicht aufrufen, um 802.1X EAP-Pakete über LAN (EAPOL) 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 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)