DOT11EXT_SET_PROFILE_CUSTOM_USER_DATA 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 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 Dot11ExtSetProfileCustomUserData pour enregistrer les données dans le registre système qui sont spécifiques à l’utilisateur actuel et au profil réseau utilisés pour la connexion réseau BSS (Basic Service Set).

Syntaxe

DOT11EXT_SET_PROFILE_CUSTOM_USER_DATA Dot11extSetProfileCustomUserData;

DWORD Dot11extSetProfileCustomUserData(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwSessionID,
  [in]           DWORD dwDataSize,
  [in]           LPVOID pvData
)
{...}

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. Cette valeur de handle a été spécifiée lors d’un appel précédent à Dot11ExtIhvPerformPreAssociate Fonction de gestionnaire IHV.

[in] dwSessionID

Identificateur de session (ID de session) de l’utilisateur actuel.

[in] dwDataSize

Taille, en octets, de la mémoire tampon référencée par pvData .

[in] pvData

Pointeur vers une mémoire tampon allouée à l’appelant, qui contient les données dans un format défini par l’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

Le système d’exploitation ne chiffre pas les données référencées par le paramètre pvData avant de les stocker dans le registre système. La DLL des extensions IHV doit utiliser son propre algorithme de chiffrement pour chiffrer les données avant d’appeler Dot11ExtSetProfileCustomUserData.

Pour chaque profil WLAN sans fil utilisé par le service Native Wifi AutoConfig, Windows conserve le concept de données utilisateur personnalisées. Ces données utilisateur personnalisées sont initialement inexistantes, mais peuvent être définies en appelant la fonction Dot11ExtSetProfileCustomUserData . Les données utilisateur personnalisées sont réinitialisées pour qu’elles se vident chaque fois que le profil est modifié en appelant le Fonction Dot11ExtSetCurrentProfile .

Une fois les données utilisateur personnalisées définies, ces données sont accessibles à l’aide du Fonction Dot11ExtGetProfileCustomUserData . Le système d’exploitation stocke les données sous le registre système HKEY_CURRENT_USER clé pour l’utilisateur référencé par le handle passé dans le paramètre dwSessionID .

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

Dot11ExtSetCurrentProfile

Dot11ExtIhvPerformPreAssociate Dot11ExtGetProfileCustomUserData

Partager via