fonction de rappel DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA (wlanihv.h)

Article
02/07/2025

important l’interface Native 802.11 Wireless LAN est déconseillée dans Windows 10 et versions ultérieures. Utilisez à la place l’interface WDI (Device Driver Interface) DU RÉSEAU LOCAL. Pour plus d’informations sur WDI, consultez modèle de pilote Windows universel LOCAL.

La DLL des extensions IHV appelle la fonction Dot11ExtGetProfileCustomUserData pour récupérer des données du registre système spécifique au profil réseau et utilisateur actuel 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 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] 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 de pointeur qui stocke l’adresse de la mémoire tampon contenant les données utilisateur.

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

Le système d’exploitation ne déchiffre pas les données référencées par le paramètre ppvData après la lecture à 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 WI-FI sans fil utilisé par le service Native Wifi AutoConfig, Windows gère 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 Dot11ExtSetProfileCustomUserData fonction. Les données utilisateur personnalisées sont réinitialisées à 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 par le paramètre ppvData à l’aide de la fonction dot11ExtFreeBuffer.

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)

Voir aussi

Dot11ExtIhvInitAdapter

Dot11ExtFreeBuffer

Dot11ExtSetProfileCustomUserData Dot11ExtIhvPerformPreAssociate

Dot11ExtSetCurrentProfile

Partager via