IEmptyVolumeCache::Initialize, méthode (emptyvc.h)

Article
08/23/2023

Initialise le gestionnaire de nettoyage de disque en fonction des informations stockées sous la clé de Registre spécifiée.

Syntaxe

HRESULT Initialize(
  [in]      HKEY    hkRegKey,
  [in]      LPCWSTR pcwszVolume,
  [out]     LPWSTR  *ppwszDisplayName,
  [out]     LPWSTR  *ppwszDescription,
  [in, out] DWORD   *pdwFlags
);

Paramètres

[in] hkRegKey

Type : HKEY

Handle de la clé de Registre qui contient les informations relatives à l’objet gestionnaire.

[in] pcwszVolume

Type : LPCWSTR

Pointeur vers une chaîne Unicode terminée par un caractère Null avec la racine du volume, par exemple, « C: ».

[out] ppwszDisplayName

Type : LPWSTR*

Pointeur vers une chaîne Unicode terminée par un caractère Null avec le nom qui sera affiché dans la liste des gestionnaires de nettoyage de disque. Si aucune valeur n’est affectée, la valeur de Registre est utilisée.

[out] ppwszDescription

Type : LPWSTR*

Pointeur vers une chaîne Unicode terminée par un caractère Null qui s’affiche lorsque cet objet est sélectionné dans la liste des gestionnaires de nettoyage de disque disponibles du gestionnaire de nettoyage de disque. Si aucune valeur n’est affectée, la valeur de Registre est utilisée.

[in, out] pdwFlags

Type : DWORD*

Indicateurs utilisés pour transmettre des informations au gestionnaire et au gestionnaire de nettoyage de disque.

Ces indicateurs peuvent être passés à l’objet :

EVCF_OUTOFDISKSPACE

Si cet indicateur est défini, l’utilisateur n’a plus d’espace disque sur le lecteur. Lorsque cet indicateur est reçu, le gestionnaire doit être agressif pour libérer de l’espace disque, même si cela entraîne une perte de performances. Toutefois, le gestionnaire ne doit pas supprimer les fichiers qui entraîneraient l’échec d’une application ou la perte de données par l’utilisateur.

EVCF_SETTINGSMODE

Si le gestionnaire de nettoyage de disque est exécuté selon une planification, il définit cet indicateur. Vous devez affecter des valeurs aux paramètres ppwszDisplayName et ppwszDescription . Si cet indicateur est défini, le gestionnaire de nettoyage de disque n’appelle pas IEmptyVolumeCache::GetSpaceUsed, IEmptyVolumeCache::P urge ou IEmptyVolumeCache::ShowProperties. Étant donné que IEmptyVolumeCache::P urge ne sera pas appelé, le nettoyage doit être géré par IEmptyVolumeCache::Initialize. Le gestionnaire doit ignorer le paramètre pcwszVolume et propre tous les fichiers inutiles, quel que soit le lecteur sur lequel ils se trouvent. Étant donné qu’il n’y a aucune possibilité de commentaires des utilisateurs, seuls les fichiers extrêmement sûrs à propre doivent être touchés.

Ces indicateurs peuvent être passés par le gestionnaire au gestionnaire de nettoyage de disque :

EVCF_DONTSHOWIFZERO

Définissez cet indicateur lorsqu’il n’y a aucun fichier à supprimer. Lorsque IEmptyVolumeCache::GetSpaceUsed est appelé, définissez le paramètre pdwSpaceUsed sur zéro, et le gestionnaire de nettoyage de disque omet le gestionnaire de sa liste.

EVCF_ENABLEBYDEFAULT

Définissez cet indicateur pour que le gestionnaire soit vérifié par défaut dans la liste du gestionnaire de nettoyage. Il s’exécute chaque fois que l’utilitaire Nettoyage de disque s’exécute, sauf si l’utilisateur efface la zone de case activée du gestionnaire. Une fois la zone de case activée désactivée, le gestionnaire n’est pas exécuté tant que l’utilisateur ne la sélectionne pas à nouveau.

EVCF_ENABLEBYDEFAULT_AUTO

Définissez cet indicateur pour que le gestionnaire s’exécute automatiquement pendant le nettoyage planifié. Cet indicateur ne doit être défini que lorsque la suppression des fichiers est à faible risque. Comme avec EVCF_ENABLEBYDEFAULT, l’utilisateur peut choisir de ne pas exécuter le gestionnaire en désactivant sa zone de case activée dans la liste du gestionnaire de nettoyage de disque.

EVCF_HASSETTINGS

Définissez cet indicateur pour indiquer que le gestionnaire peut afficher une interface utilisateur. Un exemple d’interface utilisateur simple est une zone de liste qui affiche les fichiers deletables et permet à l’utilisateur de sélectionner ceux à supprimer. Le gestionnaire de nettoyage de disque affiche ensuite un bouton sous la description du gestionnaire de nettoyage. L’utilisateur clique sur ce bouton pour demander l’interface utilisateur. Le texte du bouton par défaut est « Settings », mais le gestionnaire peut spécifier un autre texte en définissant la valeur AdvancedButtonText dans sa clé de Registre.

EVCF_REMOVEFROMLIST

Définissez cet indicateur pour supprimer le gestionnaire de la liste du gestionnaire de nettoyage de disque. Toutes les informations du Registre sont supprimées et le gestionnaire ne peut pas être réexécuter tant que la clé et ses valeurs ne sont pas restaurées. Cet indicateur est principalement utilisé pour les opérations de nettoyage à usage unique.

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	Il n’y a aucun fichier à supprimer.
E_ABORT	L’opération de nettoyage s’est terminée prématurément.
E_FAIL	L’opération de nettoyage a échoué.

Notes

Cette méthode est utilisée par le gestionnaire de nettoyage de disque Windows 98. Windows 2000 utilise la méthode InitializeEx exportée par IEmptyVolumeCache2.

Utilisez CoTaskMemAlloc pour allouer de la mémoire aux chaînes retournées via ppwszDisplayName et ppwszDescription. Le gestionnaire de nettoyage de disque libère la mémoire quand elle n’est plus nécessaire.

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