Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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) |