Funzione SHEmptyRecycleBinA (shellapi.h)
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) |