Share via

DeleteProfileA-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 DeleteProfileA(
  [in]           LPCSTR lpSidString,
  [in, optional] LPCSTR lpProfilePath,
  [in, optional] LPCSTR 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 lokale Computername verwendet.

Hinweis Ab Windows Vista muss dieser Parameter NULL sein. Ist dies nicht der Fall, 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 der Sicherheitsbezeichner (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 nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

   
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