DeleteProfileW-Funktion (userenv.h)

Löscht das Benutzerprofil und alle benutzerbezogenen Einstellungen vom angegebenen Computer. Der Aufrufer muss über Administratorrechte verfügen, um das Profil eines Benutzers zu löschen.

Syntax

USERENVAPI BOOL DeleteProfileW(
  [in]           LPCWSTR lpSidString,
  [in, optional] LPCWSTR lpProfilePath,
  [in, optional] LPCWSTR lpComputerName
);

Parameter

[in] lpSidString

Typ: LPCTSTR-

Zeigen Sie auf eine Zeichenfolge, die den Benutzer SID-angibt.

[in, optional] lpProfilePath

Typ: LPCTSTR-

Zeigen Sie auf eine Zeichenfolge, die den Profilpfad angibt. Wenn dieser Parameter NULL-ist, ruft die Funktion den Pfad aus der Registrierung ab.

[in, optional] lpComputerName

Typ: LPCTSTR-

Zeigen Sie auf eine Zeichenfolge, die den Namen des Computers angibt, von dem das Profil gelöscht werden soll. Wenn dieser Parameter NULL-ist, wird der name des lokalen Computers verwendet.

Note As of Windows Vista, this parameter must be NULL. Ist dies nicht der Fall, schlägt diese Funktion mit dem Fehlercode ERROR_INVALID_PARAMETER fehl.

 

Rückgabewert

Typ: BOOL-

TRUE bei erfolgreicher Ausführung; andernfalls FALSE. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

DeleteProfile- kann fehlschlagen, wenn die Sicherheits-ID (SID) des lokalen Systemkontos (S-1-5-18) übergeben wird.

Anmerkung

Der Header "userenv.h" definiert DeleteProfile als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	userenv.h
Library	Userenv.lib
DLL-	Userenv.dll

Siehe auch

übersicht über Benutzerprofile

Referenz zu Benutzerprofilen