fonction de rappel DOT11EXTIHV_VALIDATE_PROFILE (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.

Le système d’exploitation appelle la fonction Dot11ExtIhvValidateProfile pour valider les données utilisateur entrées pour un profil réseau. La DLL d’extensions IHV est uniquement responsable de la vérification des données des fragments de la connectivité et du profil de sécurité définis par l’IHV.

Syntaxe

DOT11EXTIHV_VALIDATE_PROFILE Dot11extihvValidateProfile;

DWORD Dot11extihvValidateProfile(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [out]          PDWORD pdwReasonCode
)
{...}

Paramètres

[in, optional] hIhvExtAdapter

Handle utilisé par la DLL d’extensions IHV pour référencer l’adaptateur LAN 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] pIhvProfileParams

Pointeur vers un structure DOT11EXT_IHV_PROFILE_PARAMS. Cette structure définit les attributs du réseau BSS (Basic Service Set) auquel les extensions de profil seront appliquées.

[in] pIhvConnProfile

Pointeur vers un DOT11EXT_IHV_CONNECTIVITY_PROFILE structure qui contient les paramètres de connectivité pour le profil IHV.

[in] pIhvSecProfile

Pointeur vers un DOT11EXT_IHV_SECURITY_PROFILE structure qui contient les paramètres de sécurité du profil IHV.

[out] pdwReasonCode

Pointeur vers une valeur DWORD, qui fournit des informations supplémentaires pour la valeur de retour de la fonction Dot11ExtIhvValidateProfile. La DLL des extensions IHV doit définir * pdwReasonCode sur une valeur L2_REASON_CODE_xxxx, qui sont définies dans L2cmn.h.

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

Le système d’exploitation appelle la fonction Dot11ExtIhvValidateProfile pour vérifier les paramètres spécifiés par l’utilisateur pour un profil réseau avant le traitement ou l’enregistrement du profil.

Lorsque la fonction Dot11ExtIhvValidateProfile est appelée, la DLL d’extensions IHV suit les instructions suivantes :

La DLL des extensions IHV vérifie que les paramètres de profil spécifiés par l’utilisateur sont valides pour les attributs généraux du réseau BSS (Basic Service Set) auquel le profil sera appliqué. Les attributs réseau BSS sont référencés via le paramètre pIhvProfileParams.
Si les données utilisateur sont valides pour les extensions de profil réseau, Dot11ExtIhvValidateProfile doivent retourner ERROR_SUCCESS. Sinon, la fonction doit retourner un code d’erreur approprié à partir des valeurs ERROR_xxxx définies dans Winerror.h.
La DLL des extensions IHV fournit plus d’informations sur les résultats de la validation des données utilisateur. La DLL doit définir * pdwReasonCode sur l’une des options suivantes :
- L2_REASON_CODE_SUCCESS, si les données utilisateur sont valides.
- Valeur d’erreur appropriée L2_REASON_CODE_xxxx, si les données utilisateur ne sont pas valides.
- Valeur définie par IHV dans la plage de L2_REASON_CODE_IHV_BASE à (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1), quelle que soit la validité des données utilisateur.

Pour plus d’informations sur le schéma XML natif 802.11, reportez-vous à la documentation du Kit de développement logiciel (SDK) Microsoft Windows.

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, L2cmn.h)

Voir aussi

DOT11EXT_IHV_CONNECTIVITY_PROFILE

DOT11EXT_IHV_PROFILE_PARAMS

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE

Partager via