DOT11EXT_ONEX_START fonction de rappel (wlanihv.h)

Article
05/23/2024

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

La DLL des 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,
  [in, optional] 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 lors d’un appel précédent à la fonction 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 Microsoft Windows SDK.

Valeur retournée

Si l’appel réussit, la fonction retourne ERROR_SUCCESS. Sinon, il 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 des 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 le point d’accès 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 de gestionnaire IHV. Pour plus d’informations sur le paquet EAPOL-Start, reportez-vous aux clauses 7.5 et 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 de 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 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 Native 802.11 802.1X.

Configuration requise

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