SHEmptyRecycleBinW-Funktion (shellapi.h)
Leert den Papierkorb auf dem angegebenen Laufwerk.
Syntax
SHSTDAPI SHEmptyRecycleBinW(
[in, optional] HWND hwnd,
[in, optional] LPCWSTR 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 den Laufwerks-, Ordner- und Unterordnernamen formatiert ist, z. B. "c:\windows\system". Sie kann auch eine leere Zeichenfolge oder NULL-enthalten. Wenn dieser Wert eine leere Zeichenfolge oder NULL-ist, werden alle Papierkörbe auf allen Laufwerken geleert.
dwFlags
Typ: DWORD-
Mindestens einer der folgenden Werte.
SHERB_NOCONFIRMATION
Es wird kein Dialogfeld angezeigt, in dem das Löschen der Objekte bestätigt wird.
SHERB_NOPROGRESSUI
Es wird kein Dialogfeld angezeigt, in dem der Fortschritt angezeigt wird.
SHERB_NOSOUND
Wenn der Vorgang abgeschlossen ist, wird kein Sound wiedergegeben.
Rückgabewert
Typ: HRESULT-
Wenn diese Funktion erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.
Bemerkungen
Anmerkung
Der shellapi.h-Header definiert SHEmptyRecycleBin als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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, Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | shellapi.h |
| Library | Shell32.lib |
| DLL- | Shell32.dll (Version 4.71 oder höher) |
| API-Satz | ext-ms-win-shell-shell32-l1-2-2 (eingeführt in Windows 10, Version 10.0.14393) |