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 |
|
| Noms Unicode et ANSI |
CreateUserProfileExW (Unicode) et CreateUserProfileExA (ANSI) |