Condividi tramite


UWF_Overlay.GetOverlayFiles

Restituisce un elenco di file di un volume memorizzati nella cache nella sovrimpressione UWF (Unified Write Filter).

Sintassi

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

Parametri

Volume
Stringa che specifica la lettera di unità o il nome del volume.

OverlayFiles
Matrice di oggetti UWF_OverlayFiles incorporati come stringhe.

Valore restituito

Restituisce un valore HRESULT che indica lo stato WMI o un errore WMI.

Osservazioni:

Per accedere a questo metodo, è necessario usare un account amministratore.

Il metodo GetOverlayFiles deve essere usato come strumento di diagnostica.

Non basare le decisioni su cosa eseguire il commit in base all'output di questo metodo.

È necessario tenere presenti le limitazioni seguenti:

  • Questo metodo è supportato solo nel file system NTFS.
  • Questo metodo richiede che una quantità significativa di memoria di sistema disponibile abbia esito positivo (in una relazione lineare con l'utilizzo della sovrimpressione). La chiamata al metodo ha esito negativo quando è disponibile memoria insufficiente per completare la chiamata.
  • Questo metodo richiede tempo significativo per il completamento (in una relazione esponenziale per sovrapporre l'utilizzo).
  • Questo metodo può mostrare i file interessati da operazioni apparentemente non correlate sia al Registro di sistema che alle esclusioni di file e ai commit.

Quando si usa il metodo GetOverlayFiles , tenere presente anche gli elementi seguenti:

  • Anche i file di cui è stato eseguito il commit con il uwfmgr.exe file commit comando sono contenuti nell'elenco dei file di sovrapposizione.
  • I file esclusi possono essere contenuti nell'elenco dei file di sovrimpressione.
  • I file inferiori alle dimensioni del cluster (ad esempio, 4 KB nella maggior parte dei casi) non verranno elencati anche se sono memorizzati nella cache in sovrimpressione.
  • Modifiche ed eliminazioni in directory escluse, file esclusi o elementi del Registro di sistema esclusi aggiungono all'utilizzo della sovrimpressione.
  • I commit dei file e del Registro di sistema aggiungono all'utilizzo della sovrimpressione.

Requisiti

Edizione per Windows Supportata
Windows Home No
Windows Pro No
Windows Enterprise
Windows Education
Windows IoT Enterprise