Funzione SHEmptyRecycleBinA (shellapi.h)

  • Articolo

Svuota il Cestino nell'unità specificata.

Sintassi

SHSTDAPI SHEmptyRecycleBinA(
  [in, optional] HWND   hwnd,
  [in, optional] LPCSTR pszRootPath,
                 DWORD  dwFlags
);

Parametri

[in, optional] hwnd

Tipo: HWND

Handle alla finestra padre di tutte le finestre di dialogo che potrebbero essere visualizzate durante l'operazione. Questo parametro può essere NULL.

[in, optional] pszRootPath

Tipo: LPCTSTR

Indirizzo di una stringa con terminazione null di lunghezza massima MAX_PATH che contiene il percorso dell'unità radice in cui si trova il Cestino. Questo parametro può contenere l'indirizzo di una stringa formattata con i nomi di unità, cartella e sottocartella, ad esempio c:\windows\system. Può anche contenere una stringa vuota o NULL. Se questo valore è una stringa vuota o NULL, tutti i cestini in tutte le unità verranno svuotati.

dwFlags

Tipo: DWORD

Uno o più dei valori seguenti.

SHERB_NOCONFIRMATION

Non verrà visualizzata alcuna finestra di dialogo che conferma l'eliminazione degli oggetti.

SHERB_NOPROGRESSUI

Nessuna finestra di dialogo che indica l'avanzamento verrà visualizzato.

SHERB_NOSOUND

Nessun suono verrà riprodotto al termine dell'operazione.

Valore restituito

Tipo: HRESULT

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

Commenti

Nota

L'intestazione shellapi.h definisce SHEmptyRecycleBin 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)
Set di API ext-ms-win-shell32-l1-2-2 (introdotta in Windows 10 versione 10.0.14393)

Vedi anche

SHQueryRecycleBin