fonction de rappel DOT11EXT_ONEX_START (wlanihv.h)

Important L’interface LAN sans fil Native 802.11 est déconseillée dans Windows 10 et versions ultérieures. Utilisez à la place l’interface WDI (Device Driver Interface). Pour plus d’informations sur WDI, consultez le 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 la DLL d’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 (WLAN) sans fil. Cette valeur de handle a été spécifiée via un appel précédent à la fonction Dot11ExtIhvInitAdapter IHV Handler.

pEapAttributes

Valeur de retour

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 d’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 (Standard Extensible Authentication Protocol) 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 peut uniquement être appelé 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 via LAN (EAPOL) à l’API. 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 l’opération d’authentification 802.1X 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 le traitement. Lorsque la DLL reçoit un paquet EAPOL par le biais d’un appel à la fonction Dot11ExtIhvReceivePacket IHV Handler, 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 d’extensions IHV est chargée de traiter EAPOL-Key paquets 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 gestionnaire IHV pour indiquer que l’autorisation est en cours.
  • La DLL d’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.

Spécifications

   
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 (inclure Wlanihv.h)

Voir aussi

Dot11ExtPostAssociateCompletion

Dot11ExtIhvReceivePacket

Dot11ExtProcessOneXPacket

Dot11ExtIhvInitAdapter

Dot11ExtIhvOneXIndicateResult Dot11ExtIhvPerformPostAssociate

Dot11ExtStopOneX