fonction de rappel DOT11EXT_SET_CURRENT_PROFILE (wlanihv.h)
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 RÉSEAU local 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] 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 par le biais d’un appel précédent au Dot11ExtIhvPerformPreAssociate fonction 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 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
La fonction Dot11ExtSetCurrentProfile permet à IHV d’ajouter des fragments de connectivité et de profil de sécurité 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 des extensions d’interface utilisateur IHV natives 802.11.
La DLL des extensions IHV doit suivre ces instructions lors de l’appel de la fonction Dot11ExtSetCurrentProfile :
- La DLL d’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 à la Dot11ExtIhvPerformPreAssociate fonction 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 à l’appel Dot11ExtIhvPerformPreAssociate fonction gestionnaire IHV. Dot11ExtSetCurrentProfile doit être appelé à partir d’un thread différent de celui qui traite l’appel à Dot11ExtIhvPerformPreAssociate.
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) |