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, um den Pfad des Stammlaufwerks zu enthalten, auf dem sich der Papierkorb befindet. Dieser Parameter kann die Adresse einer Zeichenfolge enthalten, die mit laufwerks-, ordner- und Unterordnernamen (C:\Windows\System...) formatiert ist.
[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, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
Bemerkungen
Wenn NULL unter Windows 2000 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 Papierkorbe auf allen Laufwerken abgerufen.
Hinweis
Der shellapi.h-Header definiert SHQueryRecycleBin als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der codierungsneutralen Aliase mit Code, der nicht codierungsneutral ist, kann zu Übereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| 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) |