Freigeben über

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-

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