SHEmptyRecycleBinA, fonction (shellapi.h)

Article
11/20/2024

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 vers 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 lecteur, dossier et 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 sur tous les lecteurs sont vidées.

dwFlags

Type : DWORD

Une ou plusieurs des valeurs suivantes.

SHERB_NOCONFIRMATION

Aucune boîte de dialogue confirmant la suppression des objets s’affiche.

SHERB_NOPROGRESSUI

Aucune boîte de dialogue indiquant que la progression s’affiche.

SHERB_NOSOUND

Aucun son ne sera lu lorsque l’opération est terminée.

Valeur de retour

Type : HRESULT

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

Remarques

Note

L’en-tête shellapi.h définit SHEmptyRecycleBin comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’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

Partager via