SHEmptyRecycleBinA-Funktion (shellapi.h)
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für