CreateProfile, fonction (userenv.h)

Article
08/26/2023

Crée un profil utilisateur.

Syntaxe

USERENVAPI HRESULT CreateProfile(
  [in]  LPCWSTR pszUserSid,
  [in]  LPCWSTR pszUserName,
  [out] LPWSTR  pszProfilePath,
  [in]  DWORD   cchProfilePath
);

Paramètres

[in] pszUserSid

Type : LPCWSTR

Pointeur vers le SID de l’utilisateur en tant que chaîne.

[in] pszUserName

Type : LPCWSTR

Nom d’utilisateur du nouvel utilisateur. Ce nom est utilisé comme nom de base pour le répertoire de profil.

[out] pszProfilePath

Type : LPWSTR

Lorsque cette fonction retourne, contient un pointeur vers le chemin d’accès complet du profil.

[in] cchProfilePath

Type : DWORD

Taille de la mémoire tampon pointée vers pszProfilePath, en caractères.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire, y compris les éléments suivants :

Code de retour	Description
E_ACCESSDENIED	L’appelant ne dispose pas d’un niveau d’autorisation suffisant pour créer le profil.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)	Un profil existe déjà pour l’utilisateur spécifié.

Remarques

L’appelant doit disposer de privilèges d’administrateur pour appeler cette fonction.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	userenv.h
Bibliothèque	Userenv.lib
DLL	Userenv.dll

Partager via