SHQueryRecycleBinW-Funktion (shellapi.h)

  • Artikel

Ruft die Größe des Papierkorbs und die Anzahl der Darin enthaltenen Elemente für ein angegebenes Laufwerk ab.

Syntax

SHSTDAPI SHQueryRecycleBinW(
  [in, optional] LPCWSTR         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

SHEmptyRecycleBin