UWF _ オーバーレイ. GetOverlayFilesUWF_Overlay.GetOverlayFiles

統合書き込みフィルター (UWF) オーバーレイにキャッシュされたボリュームのファイルの一覧を返します。Returns a list of files of a volume that were cached in the Unified Write Filter (UWF) overlay.

構文Syntax

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

パラメーターParameters

ボリューム ドライブ文字またはボリューム名を指定する文字列。Volume A string that specifies the drive letter or volume name.

OverlayFiles 文字列として埋め込まれた UWF _ OverlayFiles オブジェクトの配列。OverlayFiles An array of UWF_OverlayFiles objects embedded as strings.

戻り値Return Value

Wmi の状態またはwmi エラーを示す HRESULT 値を返します。Returns an HRESULT value that indicates WMI status or a WMI error.

注釈Remarks

このメソッドにアクセスするには、管理者アカウントを使用する必要があります。You must use an administrator account to access this method.

GetOverlayFiles メソッドは、診断ツールとして使用することを目的としています。The GetOverlayFiles method is intended to be used as a diagnostic tool.

このメソッドの出力に基づいてコミットする対象についての意思決定は避けてください。Do not base decisions about what to commit based on this method’s output.

次の制限事項に注意する必要があります。You should be aware of the following limitations:

  • このメソッドは、NTFS ファイルシステムでのみサポートされています。This method is only supported on the NTFS file system.
  • この方法では、十分な量の空きシステムメモリを確保する必要があります (使用量をオーバーレイする線形関係)。This method requires a significant amount of free system memory to succeed (in a linear relationship to overlay usage). 呼び出しを完了するのに十分なメモリがない場合、メソッド呼び出しは失敗します。The method call fails when there is insufficient memory available to complete the call.
  • このメソッドでは、完了までにかなりの時間が必要になります (オーバーレイの使用に指数関係があります)。This method requires significant time to complete (in an exponential relationship to overlay usage).
  • このメソッドは、レジストリとファイルの除外およびコミットの両方について、一見関係のない操作によって影響を受けるファイルを表示する場合があります。This method may show files that are affected by seemingly unrelated operations to both registry and file exclusions and commits.

GetOverlayFiles メソッドを使用する場合は、次の項目にも注意する必要があります。You should also be aware of the following items when you use the GetOverlayFiles method:

  • コマンドでコミットされたファイル uwfmgr.exe file commit は、[オーバーレイファイル] の一覧にも含まれています。Files that were committed with the uwfmgr.exe file commit command are also contained in the overlay files list.
  • 除外されたファイルは、[オーバーレイファイル] の一覧に含まれる場合があります。Excluded files may be contained in the overlay files list.
  • クラスターサイズより小さいファイル (ほとんどの場合は 4 KB など) は、オーバーレイにキャッシュされている場合でも一覧表示されません。Files that are smaller than the cluster size (for example, 4 KB in most cases) will not be listed even if they are cached in overlay.
  • 除外されたディレクトリ、除外するファイル、または除外されるレジストリ項目の変更と削除は、オーバーレイの使用に追加されます。Changes and deletions in excluded directories, excluded files, or excluded registry items add to overlay usage.
  • ファイルとレジストリのコミットはオーバーレイの使用に追加されます。File and registry commits add to overlay usage.

必要条件Requirements

Windows エディションWindows Edition サポートされていますSupported
Windows 10 HomeWindows 10 Home いいえNo
Windows 10 ProWindows 10 Pro いいえNo
Windows 10 EnterpriseWindows 10 Enterprise はいYes
Windows 10 EducationWindows 10 Education はいYes

UWF _ オーバーレイUWF_Overlay

統合書き込みフィルターUnified Write Filter