fonction de rappel DOT11EXT_ONEX_START (wlanihv.h)

Article
02/07/2025

important l’interface Native 802.11 Wireless LAN est déconseillée dans Windows 10 et versions ultérieures. Utilisez à la place l’interface WDI (Device Driver Interface) DU RÉSEAU LOCAL. Pour plus d’informations sur WDI, consultez modèle de pilote Windows universel LOCAL.

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 la DLL des extensions IHV.

Syntaxe

DOT11EXT_ONEX_START Dot11extOnexStart;

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

Paramètres

[in, optional] hDot11SvcHandle

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

[in, optional] pEapAttributes

Pointeur vers une structure de tableau EAP_ATTRIBUTES qui contient les attributs EAP retournés par la session d’authentification. Pour plus d’informations sur EAP_ATTRIBUTES, consultez la documentation du Kit de développement logiciel (SDK) Microsoft Windows.

Valeur de retour

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 des 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é qu’au cours d’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 via LAN (EAPOL) à l’AP. Si l’API ne répond pas 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 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 d’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 à l'Dot11ExtIhvReceivePacket fonction de gestionnaire IHV, 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.

Remarque 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.
Lorsque l’opération d’authentification 802.1X est terminée, le système d’exploitation appelle le Dot11ExtIhvOneXIndicateResult fonction de gestionnaire IHV pour indiquer que l’autorisation est en cours.
La DLL des 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 802.11 802.1X natif.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
plateforme cible	Bureau
d’en-tête	wlanihv.h (include Wlanihv.h)