UWF_Overlay.GetOverlayFiles

Retourne la liste des fichiers d’un volume qui ont été mis en cache dans la superposition UWF (Unified Write Filter).

Syntaxe

UInt32 GetOverlayFiles(
    [in] string Volume,
    [out, EmbeddedInstance("UWF_OverlayFile")] string OverlayFiles[]
);

Paramètres

Volume
Chaîne qui spécifie la lettre de lecteur ou le nom du volume.

OverlayFiles
Tableau d’objets UWF_OverlayFiles incorporés sous forme de chaînes.

Valeur renvoyée

Retourne une valeur HRESULT qui indique l’état de WMI ou une erreur WMI.

Remarques

Vous devez utiliser un compte administrateur pour accéder à cette méthode.

La méthode GetOverlayFiles est destinée à être utilisée comme outil de diagnostic.

Ne basez pas les décisions sur les éléments à valider en fonction de la sortie de cette méthode.

Vous devez connaître les limitations suivantes :

  • Cette méthode est uniquement prise en charge sur le système de fichiers NTFS.
  • Cette méthode nécessite une quantité importante de mémoire système libre pour réussir (dans une relation linéaire à l’utilisation de superposition). L’appel de méthode échoue quand la mémoire disponible est insuffisante pour terminer l’appel.
  • Cette méthode nécessite beaucoup de temps (dans une relation exponentielle à l’utilisation de superposition).
  • Cette méthode peut afficher des fichiers qui sont affectés par des opérations apparemment non liées à la fois aux exclusions et validations de registre et de fichiers.

Vous devez également connaître les éléments suivants lorsque vous utilisez la méthode GetOverlayFiles :

  • Les fichiers qui ont été commités avec la uwfmgr.exe file commit commande sont également contenus dans la liste des fichiers de superposition.
  • Les fichiers exclus peuvent être contenus dans la liste des fichiers superposés.
  • Les fichiers dont la taille est inférieure à la taille du cluster (par exemple, 4 Ko dans la plupart des cas) ne sont pas répertoriés, même s’ils sont mis en cache par superposition.
  • Les modifications et les suppressions dans les répertoires exclus, les fichiers exclus ou les éléments de Registre exclus s’ajoutent à l’utilisation de la superposition.
  • Les validations de fichier et de Registre s’ajoutent à l’utilisation de la superposition.

Configuration requise

Édition Windows Prise en charge
Windows Famille Non
Windows Professionnel Non
Windows Entreprise Oui
Windows Éducation Oui
Windows IoT Entreprise Oui