Partager via


UWF_Overlay.GetOverlayFiles

Retourne la liste des fichiers d’un volume 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
A chaîne qui spécifie la lettre de lecteur ou le nom du volume.

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

Valeur de retour

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

Notes

Vous devez utiliser un compte d’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 relatives à la validation 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é significative de mémoire système libre pour réussir (dans une relation linéaire avec l’utilisation de superposition). L’appel de méthode échoue en cas d’insuffisance de mémoire disponible pour terminer l’appel.
  • Cette méthode nécessite beaucoup de temps pour se terminer (dans une relation exponentielle à l’utilisation de superposition).
  • Cette méthode peut afficher les fichiers affectés par des opérations apparemment non liées aux exclusions de registre et aux validations de fichiers.

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

  • Les fichiers validé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 de superposition.
  • Les fichiers inférieurs à 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 dans une superposition.
  • Les modifications et suppressions dans les répertoires exclus, les fichiers exclus ou les éléments de Registre exclus ajoutent à l’utilisation de superposition.
  • Les validations de fichier et de Registre s’ajoutent à l’utilisation de superposition.

Spécifications

Édition Windows Pris en charge
Windows Édition familiale Non
Windows Pro Non
Windows Entreprise Oui
Windows Éducation Oui
Windows IoT Entreprise Oui