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.
Tenere presente le limitazioni seguenti:
- Questo metodo è supportato solo nel file system NTFS.
- Questo metodo richiede una quantità significativa di memoria di sistema libera per avere esito positivo (in una relazione lineare con l'utilizzo di sovrapposizione). La chiamata al metodo ha esito negativo quando non è disponibile memoria sufficiente per completare la chiamata.
- Questo metodo richiede un tempo significativo per il completamento (in una relazione esponenziale all'utilizzo di sovrimpressione).
- Questo metodo può mostrare i file interessati da operazioni apparentemente non correlate sia alle esclusioni del Registro di sistema che ai commit e ai commit dei file.
Quando si usa il metodo GetOverlayFiles , è necessario tenere presente anche gli elementi seguenti:
- I file di cui è stato eseguito il commit con il
uwfmgr.exe file commit
comando sono contenuti anche nell'elenco dei file di sovrimpressione. - 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.
- Le modifiche e le eliminazioni nelle directory escluse, nei file esclusi o negli elementi esclusi del Registro di sistema si aggiungono all'utilizzo della sovrimpressione.
- I commit dei file e del Registro di sistema si aggiungono all'utilizzo della sovrimpressione.
Requisiti
Edizione di Windows | Supportato |
---|---|
Windows Home | No |
Windows Pro | No |
Windows Enterprise | Sì |
Windows Education | Sì |
Windows IoT Enterprise | Sì |