DOT11EXT_ONEX_START fonction de rappel (wlanihv.h)

Article
03/01/2024

Important L’interface LAN sans fil Native 802.11 est déconseillée dans Windows 10 et versions ultérieures. Utilisez l’interface WDI (Wlan Device Driver Interface) à la place. Pour plus d’informations sur WDI, consultez Modèle de pilote Windows universel WLAN.

La DLL extensions IHV appelle la fonction Dot11ExtStartOneX pour lancer une opération d’authentification 802.1X avec le point d’accès (AP). Dans ce cas, l’authentification est gérée par le module 802.1X de l’infrastructure Native 802.11 au lieu de par la DLL des extensions IHV.

Syntaxe

DOT11EXT_ONEX_START Dot11extOnexStart;

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

Paramètres

[in, optional] hDot11SvcHandle

Handle utilisé par le système d’exploitation pour référencer l’adaptateur LAN sans fil (WLAN). Cette valeur de handle a été spécifiée par le biais d’un appel précédent à la fonction de gestionnaire IHV Dot11ExtIhvInitAdapter .

pEapAttributes

Valeur retournée

Si l’appel réussit, la fonction retourne ERROR_SUCCESS. Sinon, elle retourne un code d’erreur défini dans Winerror.h.

Remarques

La DLL extensions IHV peut lancer une opération d’authentification 802.1X à l’aide du module 802.1X de l’infrastructure native 802.11. Cela permet à la DLL d’utiliser les algorithmes EAP (Extensible Authentication Protocol) standard pris en charge par le système d’exploitation.

La DLL extensions IHV lance l’opération d’authentification 802.1X en appelant la fonction Dot11ExtStartOneX . Dot11ExtStartOneX ne peut être appelé que pendant une opération post-association ou une fois l’opération terminée. Pour plus d’informations sur cette opération, consultez Opérations post-association.

Lorsque la fonction Dot11ExtStartOneX est appelée, le système d’exploitation envoie un paquet de démarrage EAP sur LAN (EAPOL) à l’AP. Si l’AP ne parvient pas à répondre après trois transmissions du paquet EAPOL-Start, le système d’exploitation échoue à l’opération d’authentification 802.1X et appelle le Dot11ExtIhvOneXIndicateResult Fonction de gestionnaire IHV. Pour plus d’informations sur le paquet EAPOL-Start, reportez-vous à la clause 7.5 et à la clause 8.4.2 de la norme IEEE 802.1X-1999.

Une fois l’opération d’authentification 802.1X lancée, la DLL des extensions IHV doit suivre ces instructions.

Les extensions IHV doivent transférer tous les paquets EAPOL au système d’exploitation pour traitement. Lorsque la DLL reçoit un paquet EAPOL via un appel à la fonction gestionnaire IHV Dot11ExtIhvReceivePacket , la DLL doit appeler Dot11ExtProcessOneXPacket pour transférer le paquet au système d’exploitation.
Pour plus d’informations sur les paquets EAPOL, reportez-vous à la clause 7 de la norme IEEE 802.1X-2001.

Note La DLL des extensions IHV est responsable du traitement des paquets EAPOL-Key et ne doit pas les transférer au système d’exploitation.
Une fois l’opération d’authentification 802.1X terminée, le système d’exploitation appelle le Dot11ExtIhvOneXIndicateResult Fonction de gestionnaire IHV pour indiquer que l’autorisation est en cours.
La DLL extensions IHV peut annuler l’opération d’authentification 802.1X en appelant Dot11ExtStopOneX.

Pour plus d’informations sur l’utilisation du module 802.1X pour l’authentification, consultez Interface vers le module natif 802.11 802.1X.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	wlanihv.h (incluez Wlanihv.h)