CreateUserProfileEx, fonction

Article
06/13/2023

[Cette fonction n’est pas disponible à partir de Windows Vista.]

Crée un profil utilisateur pour un utilisateur spécifié.

Syntaxe

BOOL WINAPI CreateUserProfileEx(
  _In_      PSID    pSid,
  _In_      LPCTSTR lpUserName,
  _In_opt_  LPCTSTR lpUserHive,
  _Out_opt_ LPTSTR  lpProfileDir,
  _In_      DWORD   dwDirSize,
  _In_      BOOL    bWin9xUpg
);

Paramètres

pSid [in]

Type : PSID

SID du nouvel utilisateur.

lpUserName [in]

Type : LPCTSTR

Pointeur vers une mémoire tampon qui contient le nom d’utilisateur du nouvel utilisateur.

lpUserHive [in, facultatif]

Type : LPCTSTR

Pointeur vers une mémoire tampon qui contient la ruche du Registre à utiliser. Ce paramètre peut être NULL.

lpProfileDir [out, facultatif]

Type : LPTSTR

Pointeur vers une mémoire tampon qui, lorsque cette fonction retourne, reçoit le chemin du répertoire de profil de l’utilisateur. Ce paramètre peut être NULL.

dwDirSize [in]

Type : DWORD

Taille de la mémoire tampon spécifiée par lpProfileDir, dans les TCHAR.

bWin9xUpg [in]

Type : BOOL

TRUE si le profil utilisateur est en cours de création dans le cadre d’une migration de profil à partir de Windows 9x ; sinon, FALSE.

Quand true, le profil utilisateur est configuré dans le répertoire de profil par défaut, normalement C:\Documents and Settings\UserName. Si ce répertoire existe déjà, il est utilisé. Si ce n’est pas le cas, il est créé.

Si la valeur est FALSE, le répertoire de profil par défaut est créé s’il n’existe pas. Si le répertoire de profil par défaut existe déjà, un nouveau répertoire est créé pour ce profil utilisateur.

Valeur retournée

Type : BOOL

Retourne TRUE si le nouveau profil utilisateur a été créé avec succès ; sinon, FALSE.

Notes

Cette fonction n’est pas déclarée dans les en-têtes du kit de développement logiciel (SDK) et n’a aucune bibliothèque d’importation associée. Vous devez utiliser les fonctions LoadLibrary et GetProcAddress pour créer un lien vers Userenv.dll. La version ANSI de la fonction CreateUserProfileExA est référencée à partir de Userenv.dll en tant qu’ordinal 153. La version Unicode, CreateUserProfileExW , est référencée en tant qu’ordinal 154.

Spécifications

Condition requise	Valeur
Fin de la prise en charge des clients	Windows XP
DLL	Userenv.dll
Noms Unicode et ANSI	CreateUserProfileExW (Unicode) et CreateUserProfileExA (ANSI)

Partager via