DOT11EXT_ONEX_START Rückruffunktion (wlanihv.h)
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.
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) |