STRUCTURE PROFILEINFOW (profinfo.h)
Contient des informations utilisées lors du chargement ou du déchargement d’un profil utilisateur.
Syntaxe
typedef struct _PROFILEINFOW {
DWORD dwSize;
DWORD dwFlags;
MIDL_STRING LPWSTR lpUserName;
MIDL_STRING LPWSTR lpProfilePath;
MIDL_STRING LPWSTR lpDefaultPath;
MIDL_STRING LPWSTR lpServerName;
MIDL_STRING LPWSTR lpPolicyPath;
#if ...
ULONG_PTR hProfile;
#else
HANDLE hProfile;
#endif
} PROFILEINFOW, *LPPROFILEINFOW;
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 profil utilisateur itinérant chemin d’accès. 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 Remarques.
lpDefaultPath
Type : LPTSTR
Pointeur vers le chemin de 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 Remarques.
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 handle 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 de LoadUserProfile, Sécurité des clés de Registre et droits d’accèset Registre Hives.
Les services et applications qui appellent LoadUserProfile doivent vérifier si l’utilisateur a un profil itinérant. Si l’utilisateur a un profil itinérant, spécifiez son chemin d’accès en tant que membre lpProfilePath de cette structure.
Note
L’en-tête profinfo.h définit PROFILEINFO comme 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. Le mélange 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| d’en-tête | profinfo.h (include Userenv.h) |