SHQueryRecycleBinW-Funktion (shellapi.h)

Ruft die Größe des Papierkorbs und die Anzahl der darin gespeicherten 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 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.

Anforderungen

Siehe auch

SHEmptyRecycleBin