CreateProfile-Funktion (userenv.h)

Artikel
08/26/2023

Erstellt ein neues Benutzerprofil.

Syntax

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

Parameter

[in] pszUserSid

Typ: LPCWSTR

Zeiger auf die SID des Benutzers als Zeichenfolge.

[in] pszUserName

Typ: LPCWSTR

Der Benutzername des neuen Benutzers. Dieser Name wird als Basisname für das Profilverzeichnis verwendet.

[out] pszProfilePath

Typ: LPWSTR

Wenn diese Funktion zurückgibt, enthält einen Zeiger auf den vollständigen Pfad des Profils.

[in] cchProfilePath

Art: DWORD

Größe des Puffers, auf den von pszProfilePath in Zeichen verwiesen wird.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück, einschließlich der folgenden:

Rückgabecode	BESCHREIBUNG
E_ACCESSDENIED	Der Aufrufer verfügt nicht über eine ausreichende Berechtigungsstufe, um das Profil zu erstellen.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)	Für den angegebenen Benutzer ist bereits ein Profil vorhanden.

Hinweise

Der Aufrufer muss über Administratorrechte verfügen, um diese Funktion aufrufen zu können.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	userenv.h
Bibliothek	Userenv.lib
DLL	Userenv.dll

Freigeben über