DOT11EXT_ONEX_START Rückruffunktion (wlanihv.h)

Wichtig Die Native 802.11 Wireless LAN-Schnittstelle ist in Windows 10 und höher veraltet. Verwenden Sie stattdessen die WLAN-Gerätetreiberschnittstelle (WDI). Weitere Informationen zu WDI finden Sie im Wlan-Treibermodell für universelle Windows-Geräte.
 
Die IHV Extensions DLL ruft die Dot11ExtStartOneX-Funktion auf, um einen 802.1X-Authentifizierungsvorgang mit dem Zugriffspunkt (AP) zu initiieren. In dieser Situation wird die Authentifizierung durch das Modul 802.1X des nativen 802.11-Frameworks anstelle der IHV-Erweiterungen-DLL verwaltet.

Syntax

DOT11EXT_ONEX_START Dot11extOnexStart;

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

Parameter

[in, optional] hDot11SvcHandle

Der Handle, der vom Betriebssystem verwendet wird, um auf den WLAN-Adapter (Wireless LAN) zu verweisen. Dieser Handlewert wurde über einen vorherigen Aufruf der Funktion Dot11ExtIhvInitAdapter IHV Handler angegeben.

pEapAttributes

Rückgabewert

Wenn der Aufruf erfolgreich verläuft, gibt die Funktion ERROR_SUCCESS zurück. Andernfalls wird ein fehlercode zurückgegeben, der in Winerror.h definiert ist.

Bemerkungen

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

Die IHV-Erweiterungen-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-Startpaket (EAPOL) 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 Handler-Funktion. Weitere Informationen zum EAPOL-Start-Paket 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 IHV-Erweiterungen-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 Funktion Dot11ExtIhvReceivePacket IHV Handler empfängt, muss die DLL Dot11ExtProcessOneXPacket aufrufen, um das Paket an das Betriebssystem weiterzuleiten.

    Weitere Informationen zu EAPOL-Paketen finden Sie unter Klausel 7 des IEEE 802.1X-2001-Standards.

    Hinweis Die IHV-Erweiterungen-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 Handler-Funktion, um anzugeben, dass die Autorisierung ausgeführt wird.
  • Die IHV Extensions DLL kann den 802.1X-Authentifizierungsvorgang durch Aufrufen von Dot11ExtStopOneX abbrechen.
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

   
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und späteren Versionen der Windows-Betriebssysteme.
Zielplattform Power BI Desktop
Header wlanihv.h (include Wlanihv.h)

Weitere Informationen

Dot11ExtPostAssociateCompletion

Dot11ExtIhvReceivePacket

Dot11ExtProcessOneXPacket

Dot11ExtIhvInitAdapter

Dot11ExtIhvOneXIndicateResult Dot11ExtIhvPerformPostAssociate

Dot11ExtStopOneX