DOT11EXT_PROCESS_ONEX_PACKET fonction de rappel (wlanihv.h)

Article
02/27/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 Dot11ExtProcessOneXPacket pour transférer les paquets EAP sur LAN (EAPOL) vers le système d’exploitation pour traitement pendant une opération d’authentification 802.1X avec le point d’accès (AP).

Syntaxe

DOT11EXT_PROCESS_ONEX_PACKET Dot11extProcessOnexPacket;

DWORD Dot11extProcessOnexPacket(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           DWORD dwInPacketSize,
  [in]           LPVOID pvInPacket
)
{...}

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] dwInPacketSize

Longueur, en octets, des données de paquet dans la mémoire tampon référencées par le paramètre pvInPacket .

[in] pvInPacket

Paquet EAPOL reçu de l’AP. Le paramètre pvInPacket doit référencer le paquet EAPOL à partir du champ type de paquet dans l’unité de données de protocole EAPOL (PDU). Pour plus d’informations sur le champ type de paquet EAPOL, reportez-vous à la clause 7.5.4 de la norme IEEE 802.1X-2001.

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

Lorsqu’elle appelle la fonction Dot11ExtStartOneX , la DLL des extensions IHV lance 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.

Pendant que l’opération d’authentification 802.1X est en attente, la DLL des extensions IHV transfère les paquets EAP sur LAN (EAPOL) reçus au système d’exploitation via un appel à la fonction Dot11ExtProcessOneXPacket . La DLL des extensions IHV reçoit ces paquets via la fonction Gestionnaire IHV Dot11ExtIhvReceivePacket .

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.

Pour plus d’informations sur les paquets EAPOL, reportez-vous à la clause 7 de la norme IEEE 802.1X-2001.

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)

Voir aussi

Dot11ExtIhvReceivePacket

Dot11ExtIhvInitAdapter

Dot11ExtIhvOneXIndicateResult

Dot11ExtStartOneX

Dot11ExtStopOneX

Partager via