Funzione SHEmptyRecycleBinW (shellapi.h)
Svuota il Cestino nell'unità specificata.
Sintassi
SHSTDAPI SHEmptyRecycleBinW(
[in, optional] HWND hwnd,
[in, optional] LPCWSTR pszRootPath,
DWORD dwFlags
);
Parametri
[in, optional] hwnd
Tipo: HWND
Handle per la 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 lo stato di avanzamento.
SHERB_NOSOUND
Al termine dell'operazione non verrà riprodotto alcun suono.
Valore restituito
Tipo: HRESULT
Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT.
Osservazioni
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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
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 | Finestre |
intestazione |
shellapi.h |
libreria |
Shell32.lib |
dll | Shell32.dll (versione 4.71 o successiva) |
set di API | ext-ms-win-shell-shell32-l1-2-2 (introdotto in Windows 10, versione 10.0.14393) |