Share via

DeleteProfileW-Funktion (userenv.h)

  • Artikel

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

Zeiger auf eine Zeichenfolge, die die Benutzer-SID angibt.

[in, optional] lpProfilePath

Typ: LPCTSTR

Zeiger 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

Zeiger 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.

Hinweis Ab Windows Vista muss dieser Parameter NULL sein. Wenn dies nicht der Fall ist, schlägt diese Funktion mit dem Fehlercode ERROR_INVALID_PARAMETER fehl.
 

Rückgabewert

Typ: BOOL

TRUE , wenn erfolgreich; andernfalls FALSE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

DeleteProfile schlägt möglicherweise fehl, wenn die Sicherheits-ID (SID) des lokalen Systemkontos (S-1-5-18) übergeben wurde.

Hinweis

Der Userenv.h-Header 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
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile userenv.h
Bibliothek Userenv.lib
DLL Userenv.dll

Weitere Informationen

Übersicht über Benutzerprofile

Referenz zu Benutzerprofilen