DOT11EXT_SET_CURRENT_PROFILE fonction de rappel (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 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) |