SHQueryRecycleBinA-Funktion (shellapi.h)
Ruft die Größe des Papierkorbs und die Anzahl der Darin enthaltenen Elemente für ein angegebenes Laufwerk ab.
Syntax
SHSTDAPI SHQueryRecycleBinA(
[in, optional] LPCSTR pszRootPath,
[in, out] LPSHQUERYRBINFO pSHQueryRBInfo
);
Parameter
[in, optional] pszRootPath
Typ: LPCTSTR
Die Adresse einer null-beendeten Zeichenfolge mit maximaler Länge MAX_PATH den Pfad des Stammlaufwerks enthalten, auf dem sich der Papierkorb befindet. Dieser Parameter kann die Adresse einer Zeichenfolge enthalten, die mit den Laufwerks-, Ordner- und Unterordnernamen formatiert ist (C:\Windows\System...).
[in, out] pSHQueryRBInfo
Typ: LPSHQUERYRBINFO
Die Adresse einer SHQUERYRBINFO-Struktur , die die Papierkorbinformationen empfängt. Das cbSize-Element der Struktur muss auf die Größe der Struktur festgelegt werden, bevor diese API aufgerufen wird.
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Wenn bei Windows 2000 NULL im pszRootPath-Parameter übergeben wird, schlägt die Funktion fehl und gibt einen E_INVALIDARG Fehlercode zurück. In früheren Versionen des Betriebssystems können Sie eine leere Zeichenfolge oder NULL übergeben. Wenn pszRootPath eine leere Zeichenfolge oder NULL enthält, werden Informationen für alle Papierkörbe auf allen Laufwerken abgerufen.
Hinweis
Der shellapi.h-Header definiert SHQueryRecycleBin 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 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) |
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