DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA fonction de rappel (wlanihv.h)

Article
03/05/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 des extensions IHV appelle la fonction Dot11ExtGetProfileCustomUserData pour récupérer des données du registre système spécifique à l’utilisateur actuel et au profil réseau utilisé pour la connexion réseau BSS (Basic Service Set).

Syntaxe

DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA Dot11extGetProfileCustomUserData;

DWORD Dot11extGetProfileCustomUserData(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwSessionID,
  [out]          DWORD *pdwDataSize,
  [out]          LPVOID *ppvData
)
{...}

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] dwSessionID

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

[out] pdwDataSize

Pointeur vers une variable fournie par l’appelant qui stocke la taille, en octets, de la mémoire tampon référencée par ppvData .

[out] ppvData

Adresse d’une variable pointeur qui stocke l’adresse de la mémoire tampon contenant les données utilisateur.

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 déchiffre pas les données référencées par le paramètre ppvData après les avoir lues à partir du registre système. La DLL des extensions IHV doit utiliser son propre algorithme de déchiffrement pour déchiffrer les données après avoir appelé Dot11ExtGetProfileCustomUserData.

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 le 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 de la fonction Dot11ExtGetProfileCustomUserData .

L’appelant est chargé de libérer la mémoire allouée pour la mémoire tampon pointée vers le paramètre ppvData à l’aide de la fonction Dot11ExtFreeBuffer .

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

Dot11ExtFreeBuffer

Dot11ExtSetProfileCustomUserData Dot11ExtIhvPerformPreAssociate

Dot11ExtSetCurrentProfile

Partager via