STRUCTURE PROFILEINFOA (profinfo.h)
Contient les informations utilisées lors du chargement ou du déchargement d’un profil utilisateur.
Syntaxe
typedef struct _PROFILEINFOA {
DWORD dwSize;
DWORD dwFlags;
MIDL_STRING LPSTR lpUserName;
MIDL_STRING LPSTR lpProfilePath;
MIDL_STRING LPSTR lpDefaultPath;
MIDL_STRING LPSTR lpServerName;
MIDL_STRING LPSTR lpPolicyPath;
#if ...
ULONG_PTR hProfile;
#else
HANDLE hProfile;
#endif
} PROFILEINFOA, *LPPROFILEINFOA;
Membres
dwSize
Type : DWORD
Taille de cette structure, en octets.
dwFlags
Type : DWORD
Ce membre peut être l’un des indicateurs suivants :
PI_NOUI
Empêche l’affichage des messages d’erreur de profil.
PI_APPLYPOLICY
Non pris en charge.
lpUserName
Type : LPTSTR
Pointeur vers le nom de l’utilisateur. Ce membre est utilisé comme nom de base du répertoire dans lequel stocker un nouveau profil.
lpProfilePath
Type : LPTSTR
Pointeur vers le chemin du profil utilisateur itinérant . Si l’utilisateur n’a pas de profil itinérant, ce membre peut être NULL. Pour récupérer le chemin du profil itinérant de l’utilisateur, appelez la fonction NetUserGetInfo , en spécifiant le niveau d’informations 3 ou 4. Pour plus d'informations, consultez la section Notes.
lpDefaultPath
Type : LPTSTR
Pointeur vers le chemin d’accès du profil utilisateur par défaut. Ce membre peut être NULL.
lpServerName
Type : LPTSTR
Pointeur vers le nom du contrôleur de domaine de validation, au format NetBIOS.
lpPolicyPath
Type : LPTSTR
Non utilisé, défini sur NULL.
hProfile
Type : HANDLE
Handle de la sous-arborescence du Registre HKEY_CURRENT_USER . Pour plus d'informations, consultez la section Notes.
Remarques
N’utilisez pas de variables d’environnement lors de la spécification d’un chemin d’accès. La fonction LoadUserProfile ne développe pas les variables d’environnement, telles que %username%, dans un chemin d’accès.
Lorsque l’appel LoadUserProfile retourne correctement, le membre hProfile reçoit un descripteur de clé de Registre ouvert à la racine de la sous-arborescence de l’utilisateur, ouvert avec un accès complet (KEY_ALL_ACCESS). Pour plus d’informations, consultez les sections Remarques dans LoadUserProfile, Sécurité de la clé de Registre et droits d’accès et Hives du Registre.
Les services et applications qui appellent LoadUserProfile doivent case activée pour voir si l’utilisateur dispose d’un profil itinérant. Si l’utilisateur a un profil itinérant, spécifiez son chemin en tant que membre lpProfilePath de cette structure.
Notes
L’en-tête profinfo.h définit PROFILEINFO en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
En-tête | profinfo.h (include Userenv.h) |