CreateUserProfileEx-Funktion

[Diese Funktion ist ab Windows Vista nicht verfügbar.]

Erstellt ein Benutzerprofil für einen angegebenen Benutzer.

Syntax

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

Parameter

pSid [in]

Typ: PSID

Die SID des neuen Benutzers.

lpUserName [in]

Typ: LPCTSTR

Zeiger auf einen Puffer, der den Benutzernamen des neuen Benutzers enthält.

lpUserHive [in, optional]

Typ: LPCTSTR

Zeiger auf einen Puffer, der die zu verwendende Registrierungsstruktur enthält. Dieser Parameter kann NULL sein.

lpProfileDir [out, optional]

Typ: LPTSTR

Zeiger auf einen Puffer, der den Profilverzeichnispfad des Benutzers empfängt, wenn diese Funktion zurückgibt. Dieser Parameter kann NULL sein.

dwDirSize [in]

Art: DWORD

Größe des von lpProfileDir angegebenen Puffers in TCHARs.

bWin9xUpg [in]

Typ: BOOL

TRUE , wenn das Benutzerprofil im Rahmen einer Profilmigration von Windows 9x erstellt wird; andernfalls FALSE.

Bei TRUE wird das Benutzerprofil im Standardprofilverzeichnis eingerichtet, normalerweise C:\Dokumente und Einstellungen\Benutzername. Wenn dieses Verzeichnis bereits vorhanden ist, wird es verwendet. Wenn dies nicht der Fall ist, wird es erstellt.

Bei FALSE wird das Standardprofilverzeichnis erstellt, wenn es nicht vorhanden ist. Wenn das Standardprofilverzeichnis bereits vorhanden ist, wird ein neues Verzeichnis für dieses Benutzerprofil erstellt.

Rückgabewert

Typ: BOOL

Gibt TRUE zurück, wenn das neue Benutzerprofil erfolgreich erstellt wurde. andernfalls FALSE.

Bemerkungen

Diese Funktion ist nicht in den SDK-Headern (Software Development Kit) deklariert und verfügt über keine zugehörige Importbibliothek. Sie müssen die Funktionen LoadLibrary und GetProcAddress verwenden, um eine Verknüpfung mit Userenv.dll. Auf die ANSI-Version der Funktion CreateUserProfileExA wird von Userenv.dll als Ordnungszahl 153 verwiesen. Auf die Unicode-Version CreateUserProfileExW wird als Ordnungszahl 154 verwiesen.

Anforderungen

Anforderung	Wert
Ende des Supports (Client)	Windows XP
DLL	Userenv.dll
Unicode- und ANSI-Name	CreateUserProfileExW (Unicode) und CreateUserProfileExA (ANSI)