Partager via


Fonction SHEmptyRecycleBinA (shellapi.h)

Vide la Corbeille sur le lecteur spécifié.

Syntaxe

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

Paramètres

[in, optional] hwnd

Type : HWND

Handle de la fenêtre parente de toutes les boîtes de dialogue qui peuvent être affichées pendant l’opération. Ce paramètre peut être NULL.

[in, optional] pszRootPath

Type : LPCTSTR

Adresse d’une chaîne terminée par null de longueur maximale MAX_PATH qui contient le chemin d’accès du lecteur racine sur lequel se trouve la Corbeille. Ce paramètre peut contenir l’adresse d’une chaîne mise en forme avec les noms de lecteur, de dossier et de sous-dossier, par exemple c :\windows\system. Il peut également contenir une chaîne vide ou NULL. Si cette valeur est une chaîne vide ou NULL, toutes les corbeilles de tous les lecteurs seront vidées.

dwFlags

Type : DWORD

Une ou plusieurs des valeurs suivantes.

SHERB_NOCONFIRMATION

Aucune boîte de dialogue confirmant la suppression des objets ne sera affichée.

SHERB_NOPROGRESSUI

Aucune boîte de dialogue indiquant la progression ne sera affichée.

SHERB_NOSOUND

Aucun son n’est lu une fois l’opération terminée.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Notes

L’en-tête shellapi.h définit SHEmptyRecycleBin comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête shellapi.h
Bibliothèque Shell32.lib
DLL Shell32.dll (version 4.71 ou ultérieure)
Ensemble d’API ext-ms-win-shell-shell32-l1-2-2 (introduit dans Windows 10, version 10.0.14393)

Voir aussi

SHQueryRecycleBin