Freigeben über

UWF_Overlay.GetOverlayFiles

  • Artikel
  • Gilt für::
    ✅ Windows 11, ✅ Windows 10

Gibt eine Liste der Dateien eines Volumes zurück, das in der UWF-Überlagerung (Unified Write Filter, einheitlicher Schreibfilter) zwischengespeichert wurde.

Syntax

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

Parameter

Volume
A string that specifies the drive letter or volume name.

OverlayFiles
Ein Array von UWF_OverlayFiles Objekten, die als Zeichenfolgen eingebettet sind.

Rückgabewert

Gibt einen HRESULT - Wert zurück, der den WMI - Status oder einen WMI - Fehler angibt.

Hinweise

Sie müssen ein Administratorkonto verwenden, um auf diese Methode zuzugreifen.

Die GetOverlayFiles-Methode soll als Diagnosetool verwendet werden.

Entscheiden Sie nicht auf der Grundlage der Ausgabe dieser Methode, was übernommen werden soll.

Beachten Sie die folgenden Einschränkungen:

  • Diese Methode wird nur im NTFS-Dateisystem unterstützt.
  • Diese Methode erfordert eine erhebliche Menge an freiem Systemspeicher, um erfolgreich zu sein (in einem linearen Verhältnis zur Überlagerungsnutzung). Der Methodenaufruf schlägt fehl, wenn nicht genügend Arbeitsspeicher zur Verfügung steht, um den Aufruf abzuschließen.
  • Diese Methode erfordert einen erheblichen Zeitaufwand (in einem exponentiellen Verhältnis zur Überlagerungsnutzung).
  • Diese Methode kann Dateien anzeigen, die von scheinbar nicht mit der Registrierung und den Dateiausschlüssen und -Commits verbundenen Vorgängen betroffen sind.

Beachten Sie auch die folgenden Elemente, wenn Sie die GetOverlayFiles-Methode verwenden:

  • Dateien, die mit dem uwfmgr.exe file commit-Befehl übernommen wurden, sind auch in der Liste der Überlagerungsdateien enthalten.
  • Ausgeschlossene Dateien können in der Überlagerungsdateienliste enthalten sein.
  • Dateien, die kleiner als die Clustergröße sind (z. B. 4 KB in den meisten Fällen), werden nicht aufgelistet, auch wenn sie in der Überlagerung zwischengespeichert werden.
  • Änderungen und Löschungen in ausgeschlossenen Verzeichnissen, ausgeschlossenen Dateien oder ausgeschlossenen Registrierungselementen tragen zur Überlagerungsnutzung bei.
  • Datei- und Registrierungs-Commits tragen zur Überlagerungsnutzung bei.

Anforderungen

Windows-Edition Unterstützt
Windows Home Nein
Windows Pro Nein
Windows Enterprise Ja
Windows Education Ja
Windows IoT Enterprise Ja