DOT11EXT_SET_CURRENT_PROFILE fonction de rappel (wlanihv.h)

  • Article
Important L’interface LAN sans fil Native 802.11 est déconseillée dans Windows 10 et versions ultérieures. Utilisez l’interface WDI (Wlan Device Driver Interface) à la place. Pour plus d’informations sur WDI, consultez Modèle de pilote Windows universel WLAN.
 
La DLL extensions IHV appelle la fonction Dot11ExtSetCurrentProfile pour spécifier les paramètres des fragments de profil de sécurité et de connectivité définis par IHV. Ces fragments seront appliqués au profil réseau actuel.

Syntaxe

DOT11EXT_SET_CURRENT_PROFILE Dot11extSetCurrentProfile;

DWORD Dot11extSetCurrentProfile(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in, optional] PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in, optional] PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile
)
{...}

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 par le biais d’un appel précédent à la fonction de gestionnaire IHV Dot11ExtIhvInitAdapter .

[in, optional] hConnectSession

Handle utilisé par le système d’exploitation pour référencer la session de connexion avec le réseau BSS (Basic Service Set). Cette valeur de handle a été spécifiée lors d’un appel précédent à Dot11ExtIhvPerformPreAssociate Fonction de gestionnaire IHV.

[in, optional] pIhvConnProfile

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

[in, optional] pIhvSecProfile

Pointeur vers un DOT11EXT_IHV_SECURITY_PROFILE structure qui spécifie les paramètres de sécurité pour le profil IHV.

Valeur retournée

Si l’appel réussit, la fonction retourne ERROR_SUCCESS. Sinon, elle retourne un code d’erreur défini dans Winerror.h.

Remarques

La fonction Dot11ExtSetCurrentProfile permet à l’IHV d’ajouter des fragments de profil de sécurité et de connectivité personnalisés au profil réseau actuel utilisé pour la connexion réseau BSS (Basic Service Set). Les fragments de profil sont spécifiques à IHV et s’appliquent aux extensions de connectivité ou de sécurité disponibles pour l’utilisateur via la DLL Native 802.11 IHV UI Extensions.

La DLL des extensions IHV doit suivre ces instructions lors de l’appel de la fonction Dot11ExtSetCurrentProfile :

  • La DLL des extensions IHV doit uniquement appeler Dot11ExtSetCurrentProfile lors de l’exécution d’une opération de pré-association lancée par le biais d’un appel à Dot11ExtIhvPerformPreAssociate Fonction de gestionnaire IHV. Pour plus d’informations sur l’opération de pré-association, consultez Opération de pré-association.
  • La DLL des extensions IHV ne doit pas appeler Dot11ExtSetCurrentProfile à partir de l’appel à Dot11ExtIhvPerformPreAssociate Fonction de gestionnaire IHV. Dot11ExtSetCurrentProfile doit être appelé à partir d’un thread différent de celui qui traite l’appel à Dot11ExtIhvPerformPreAssociate.

Configuration requise

Condition requise Valeur
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 (incluez Wlanihv.h)

Voir aussi

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE

Dot11ExtIhvPerformPreAssociate DOT11EXT_IHV_CONNECTIVITY_PROFILE