Partager via

STRUCTURE PROFILEINFOW (profinfo.h)

  • Article

Contient les 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 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)

Voir aussi

LoadUserProfile

UnloadUserProfile

Vue d’ensemble des profils utilisateur