Funzione CreateUserProfileEx

[Questa funzione non è disponibile a partire da Windows Vista.]

Crea un profilo utente per un utente specificato.

Sintassi

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

Parametri

pSid [in]

Tipo: PSID

SID del nuovo utente.

lpUserName [in]

Tipo: LPCTSTR

Puntatore a un buffer contenente il nome utente del nuovo utente.

lpUserHive [in, facoltativo]

Tipo: LPCTSTR

Puntatore a un buffer contenente l'hive del Registro di sistema da usare. Questo parametro può essere NULL.

lpProfileDir [out, facoltativo]

Tipo: LPTSTR

Puntatore a un buffer che, quando questa funzione viene restituita, riceve il percorso della directory del profilo dell'utente. Questo parametro può essere NULL.

dwDirSize [in]

Tipo: DWORD

Dimensioni del buffer specificato da lpProfileDir, in TCHAR.

bWin9xUpg [in]

Tipo: BOOL

TRUE se il profilo utente viene creato come parte di una migrazione del profilo da Windows 9x; in caso contrario, FALSE.

Se TRUE, il profilo utente viene configurato nella directory del profilo predefinita, in genere C:\Documents and Settings\UserName. Se la directory esiste già, viene usata. In caso contrario, viene creato.

Se FALSE, la directory del profilo predefinita viene creata se non esiste. Se la directory del profilo predefinita esiste già, viene creata una nuova directory per questo profilo utente.

Valore restituito

Tipo: BOOL

Restituisce TRUE se il nuovo profilo utente è stato creato correttamente; in caso contrario, FALSE.

Commenti

Questa funzione non è dichiarata nelle intestazioni di Software Development Kit (SDK) e non ha alcuna libreria di importazione associata. È necessario usare le funzioni LoadLibrary e GetProcAddress per collegarsi a Userenv.dll. La versione ANSI della funzione CreateUserProfileExA viene fatto riferimento da Userenv.dll come ordinale 153. La versione Unicode CreateUserProfileExW viene fatto riferimento come ordinale 154.

Requisiti

Requisito	Valore
Fine del supporto client	Windows XP
DLL	Userenv.dll
Nomi Unicode e ANSI	CreateUserProfileExW (Unicode) e CreateUserProfileExA (ANSI)