Funzione SHQueryRecycleBinA (shellapi.h)

  • Articolo

Recupera le dimensioni del Cestino e il numero di elementi in esso contenuti, per un'unità specificata.

Sintassi

SHSTDAPI SHQueryRecycleBinA(
  [in, optional] LPCSTR          pszRootPath,
  [in, out]      LPSHQUERYRBINFO pSHQueryRBInfo
);

Parametri

[in, optional] pszRootPath

Tipo: LPCTSTR

Indirizzo di una stringa con terminazione null di lunghezza massima MAX_PATH per contenere il percorso dell'unità radice in cui si trova il Cestino. Questo parametro può contenere l'indirizzo di una stringa formattata con i nomi unità, cartella e sottocartella (C:\Windows\System...).

[in, out] pSHQueryRBInfo

Tipo: LPSHQUERYRBINFO

Indirizzo di una struttura SHQUERYRBINFO che riceve le informazioni sul Cestino. Il membro cbSize della struttura deve essere impostato sulle dimensioni della struttura prima di chiamare questa API.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Con Windows 2000, se NULL viene passato nel parametro pszRootPath , la funzione ha esito negativo e restituisce un codice di errore E_INVALIDARG. Nelle versioni precedenti del sistema operativo è possibile passare una stringa vuota o NULL. Se pszRootPath contiene una stringa vuota o NULL, le informazioni vengono recuperate per tutti i Cestini in tutte le unità.

Nota

L'intestazione shellapi.h definisce SHQueryRecycleBin come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shellapi.h
Libreria Shell32.lib
DLL Shell32.dll (versione 4.71 o successiva)

Vedi anche

SHEmptyRecycleBin