Méthode IEmptyVolumeCache ::GetSpaceUsed (emptyvc.h)

Article
08/23/2023

Demande la quantité d’espace disque que le gestionnaire de nettoyage de disque peut libérer.

Syntaxe

HRESULT GetSpaceUsed(
  [out] DWORDLONG                 *pdwlSpaceUsed,
  [in]  IEmptyVolumeCacheCallBack *picb
);

Paramètres

[out] pdwlSpaceUsed

Type : DWORDLONG*

Quantité d’espace disque, en octets, que le gestionnaire peut libérer. Cette valeur s’affiche dans la liste du gestionnaire de nettoyage de disque, à droite de la zone de case activée du gestionnaire. Pour indiquer que vous ne savez pas combien d’espace disque peut être libéré, définissez ce paramètre sur -1 et « ??? Mo » s’affiche. Si vous définissez l’indicateur EVCF_DONTSHOWIFZERO lors de l’appel d’Initialize , la définition de pdwSpaceUsed sur zéro avertit le gestionnaire de nettoyage de disque d’omettre le gestionnaire de sa liste.

[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 ScanProgress de cette 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	Opération réussie.
S_FALSE	Une erreur s’est produite lorsque le gestionnaire a essayé de calculer la quantité d’espace disque qui pouvait être libéré.
E_ABORT	L’opération d’analyse a été arrêtée prématurément. Cette valeur est généralement retournée lorsqu’un appel à ScanProgress retourne E_ABORT. Cette valeur de retour indique que l’utilisateur a annulé l’opération en cliquant sur le bouton Annuler du gestionnaire de nettoyage de disque.

Remarques

Lorsque cette méthode est appelée par le gestionnaire de nettoyage de disque, le gestionnaire doit commencer à analyser ses fichiers pour déterminer ceux qui peuvent être supprimés et l’espace disque qui sera libéré. Les gestionnaires doivent appeler régulièrement IEmptyVolumeCache ::ScanProgress pour tenir l’utilisateur informé de la progression de l’analyse, en particulier si celle-ci prend beaucoup de temps. L’appel fréquent de cette méthode permet également au gestionnaire de déterminer si l’utilisateur a annulé l’opération. Si ScanProgress retourne E_ABORT, l’utilisateur a annulé l’analyse. Le gestionnaire doit immédiatement arrêter l’analyse et retourner E_ABORT.

Vous devez uniquement définir le paramètre pdwSpaceUsed sur -1 en dernier recours. Le gestionnaire a une valeur limitée pour un utilisateur s’il ne sait pas combien d’espace sera libéré.

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 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