Condividi tramite


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)

Vedere anche

SHQueryRecycleBin