SHQueryRecycleBinA-Funktion (shellapi.h)
Ruft die Größe des Papierkorbs und die Anzahl der darin gespeicherten 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 eines null-terminated string of maximum length MAX_PATH to contain the path of the root drive on which the recycle bin is located. Dieser Parameter kann die Adresse einer Zeichenfolge enthalten, die mit den 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 Mitglied der Struktur muss vor dem Aufrufen dieser API auf die Größe der Struktur festgelegt werden.
Rückgabewert
Typ: HRESULT-
Wenn diese Funktion erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.
Bemerkungen
Wenn NULL- mit 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 Papierkörbe auf allen Laufwerken abgerufen.
Anmerkung
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 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) |