SHEmptyRecycleBinA-Funktion (shellapi.h)

  • Artikel

Leert den Papierkorb auf dem angegebenen Laufwerk.

Syntax

SHSTDAPI SHEmptyRecycleBinA(
  [in, optional] HWND   hwnd,
  [in, optional] LPCSTR pszRootPath,
                 DWORD  dwFlags
);

Parameter

[in, optional] hwnd

Typ: HWND

Ein Handle für das übergeordnete Fenster aller Dialogfelder, die während des Vorgangs möglicherweise angezeigt werden. Dieser Parameter kann NULL sein.

[in, optional] pszRootPath

Typ: LPCTSTR

Die Adresse einer null-beendeten Zeichenfolge mit maximaler Länge MAX_PATH, die den Pfad des Stammlaufwerks enthält, auf dem sich der Papierkorb befindet. Dieser Parameter kann die Adresse einer Zeichenfolge enthalten, die mit laufwerks-, ordner- und Unterordnernamen formatiert ist, z. B. c:\windows\system. Es kann auch eine leere Zeichenfolge oder NULL enthalten. Wenn dieser Wert eine leere Zeichenfolge oder NULL ist, werden alle Papierkörge auf allen Laufwerken geleert.

dwFlags

Art: DWORD

Mindestens einer der folgenden Werte:

SHERB_NOCONFIRMATION

Es wird kein Dialogfeld angezeigt, das das Löschen der Objekte bestätigt.

SHERB_NOPROGRESSUI

Es wird kein Dialogfeld angezeigt, das den Fortschritt angibt.

SHERB_NOSOUND

Nach Abschluss des Vorgangs wird kein Ton wiedergegeben.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Hinweis

Der shellapi.h-Header definiert SHEmptyRecycleBin 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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shellapi.h
Bibliothek Shell32.lib
DLL Shell32.dll (Version 4.71 oder höher)
APIs ext-ms-win-shell-shell32-l1-2-2 (eingeführt in Windows 10, Version 10.0.14393)

Weitere Informationen

SHQueryRecycleBin