IEmptyVolumeCacheCallBack ::P urgeProgress, méthode (emptyvc.h)

Article
02/01/2024

Appelé régulièrement par un gestionnaire de nettoyage de disque pour mettre à jour le gestionnaire de nettoyage de disque en fonction de la progression d’un vidage des fichiers pouvant être ajoutés.

Syntaxe

HRESULT PurgeProgress(
  [in] DWORDLONG dwlSpaceFreed,
  [in] DWORDLONG dwlSpaceToFree,
  [in] DWORD     dwFlags,
  [in] LPCWSTR   pcwszStatus
);

Paramètres

[in] dwlSpaceFreed

Type : DWORDLONG

Quantité d’espace disque, en octets, qui a été libérée à ce stade du vidage. Le gestionnaire de nettoyage de disque utilise cette valeur pour mettre à jour sa barre de progression.

[in] dwlSpaceToFree

Type : DWORDLONG

Quantité d’espace disque, en octets, qui reste à libérer à ce stade du vidage.

[in] dwFlags

Type : DWORD

Indicateur qui peut être envoyé au gestionnaire de nettoyage de disque. Elle peut avoir la valeur suivante :

EVCCBF_LASTNOTIFICATION

Cet indicateur doit être défini si le gestionnaire n’appelle pas à nouveau cette méthode. Il est généralement défini lorsque le vidage est presque terminé.

[in] pcwszStatus

Type : LPCWSTR

Réservé.

Valeur retournée

Type : HRESULT

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

Code de retour	Description
S_OK	Le gestionnaire doit continuer à purger les fichiers deletables.
E_ABORT	Cette valeur est retournée lorsque l’utilisateur clique sur le bouton Annuler dans la boîte de dialogue du gestionnaire de nettoyage de disque pendant qu’une analyse est en cours. Le gestionnaire doit arrêter le vidage des fichiers et s’arrêter.

Remarques

Cette méthode est généralement appelée par la méthode Purge du gestionnaire pendant que le gestionnaire purge les fichiers deletables. Les gestionnaires doivent appeler PurgeProgress régulièrement pour tenir l’utilisateur informé de la progression, en particulier si le vidage prend beaucoup de temps. L’appel fréquent de cette méthode permet également au gestionnaire de s’arrêter rapidement si un utilisateur annule un vidage.

Configuration requise


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