DOT11EXTIHV_VALIDATE_PROFILE 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.

Le système d’exploitation appelle la fonction Dot11ExtIhvValidateProfile pour valider les données utilisateur entrées pour un profil réseau. La DLL des extensions IHV est uniquement responsable de la vérification des données pour les fragments du profil de connectivité et de sécurité défini 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 des extensions IHV 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] pIhvProfileParams

Pointeur vers un DOT11EXT_IHV_PROFILE_PARAMS structure. 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 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

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 que le profil ne soit traité ou enregistré.

Lorsque la fonction Dot11ExtIhvValidateProfile est appelée, la DLL des 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 doit 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’un des éléments suivants :
- L2_REASON_CODE_SUCCESS, si les données utilisateur sont valides.
- Une valeur d’erreur L2_REASON_CODE_xxxx appropriée, 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 Native 802.11, reportez-vous à la documentation Microsoft Windows SDK.

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

Voir aussi

DOT11EXT_IHV_CONNECTIVITY_PROFILE

DOT11EXT_IHV_PROFILE_PARAMS

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE

Partager via