Funzione CreateProfile (userenv.h)

Articolo
08/26/2023

Crea un nuovo profilo utente.

Sintassi

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

Parametri

[in] pszUserSid

Tipo: LPCWSTR

Puntatore al SID dell'utente come stringa.

[in] pszUserName

Tipo: LPCWSTR

Nome utente del nuovo utente. Questo nome viene usato come nome di base per la directory del profilo.

[out] pszProfilePath

Tipo: LPWSTR

Quando questa funzione restituisce, contiene un puntatore al percorso completo del profilo.

[in] cchProfilePath

Tipo: DWORD

Dimensioni del buffer a cui punta pszProfilePath, in caratteri.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario, incluso quanto segue:

Codice restituito	Descrizione
E_ACCESSDENIED	Il chiamante non ha un livello di autorizzazione sufficiente per creare il profilo.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)	Esiste già un profilo per l'utente specificato.

Commenti

Il chiamante deve avere privilegi di amministratore per chiamare questa funzione.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	userenv.h
Libreria	Userenv.lib
DLL	Userenv.dll

Condividi tramite