CreateUserProfileEx fonction)

[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 [ dans]

Type : PSID

SID du nouvel utilisateur.

lpUserName [ dans]

Type : LPCTSTR

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

lpUserHive [ dans, facultatif]

Type : LPCTSTR

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

lpProfileDir [ out, facultatif]

Type : LPTStr

Pointeur vers une mémoire tampon qui, lorsque cette fonction est retournée, reçoit le chemin d’accès au répertoire de profil de l’utilisateur. Ce paramètre peut être NULL.

dwDirSize [ dans]

Type : DWORD

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

bWin9xUpg [ dans]

Type : bool

TRUE si le profil utilisateur est créé dans le cadre d’une migration de profil à partir de Windows 9x ; Sinon, false.

si la valeur est TRUE, le profil utilisateur est configuré dans le répertoire de profil par défaut, normalement C : \ Documents et Paramètres \ nom d’utilisateur. 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 de retour

Type : bool

Retourne la valeur 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 pas de bibliothèque d’importation associée. Vous devez utiliser les fonctions LoadLibrary et GetProcAddress pour établir une liaison à 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 sous la forme ordinale 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)