IEmptyVolumeCache::P urge, méthode (emptyvc.h)

Article
08/23/2023

Avertit le gestionnaire de commencer à supprimer ses fichiers inutiles.

Syntaxe

HRESULT Purge(
  [in] DWORDLONG                 dwlSpaceToFree,
  [in] IEmptyVolumeCacheCallBack *picb
);

Paramètres

[in] dwlSpaceToFree

Type : DWORDLONG

Quantité d’espace disque que le gestionnaire doit libérer. Si ce paramètre a la valeur -1, le gestionnaire doit supprimer tous ses fichiers.

[in] picb

Type : IEmptyVolumeCacheCallback*

Pointeur vers l’interface IEmptyVolumeCacheCallBack du gestionnaire de nettoyage de disque. Ce pointeur peut être utilisé pour appeler la méthode PurgeProgress de l’interface pour signaler la progression de l’opération.

Valeur retournée

Type : HRESULT

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Réussite.
E_ABORT	L’opération a pris fin prématurément. Cette valeur est généralement retournée lorsque PurgeProgress retourne E_ABORT. Cela se produit généralement lorsque l’utilisateur annule l’opération en cliquant sur le bouton Annuler du gestionnaire de nettoyage de disque.

Notes

Pour Windows 98, le paramètre dwSpaceToFree est toujours défini sur la valeur spécifiée par le gestionnaire lorsque IEmptyVolumeCache::GetSpaceUsed a été appelé.

En général, les gestionnaires doivent rester simples et supprimer tous leurs fichiers lorsque cette fonction est appelée. Si la suppression d’une partie des fichiers présente des avantages significatifs en matière de performances, le gestionnaire doit implémenter la méthode ShowProperties . Lorsqu’elle est appelée, cette méthode affiche une interface utilisateur qui permet à l’utilisateur de sélectionner les fichiers à supprimer.

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	emptyvc.h
DLL	Shell32.dll (version 5.0 ou ultérieure)

Partager via