UWF_Overlay.GetOverlayFiles
統合書き込みフィルター (UWF) オーバーレイにキャッシュされたボリュームのファイル一覧を返します。
構文
UInt32 GetOverlayFiles(
[in] string Volume,
[out, EmbeddedInstance("UWF_OverlayFile")] string OverlayFiles[]
);
パラメーター
Volume
ドライブ文字またはボリューム名を指定する文字列。
OverlayFiles
文字列として埋め込まれた UWF_OverlayFiles オブジェクトの配列。
戻り値
WMI の状態または WMI エラーを示す HRESULT 値を返します。
解説
このメソッドにアクセスするには、管理者アカウントを使用する必要があります。
GetOverlayFiles メソッドは、診断ツールとして使用することを目的としています。
このメソッドの出力に基づいてコミットする内容についての決定は行わないでください。
次の制限事項に注意する必要があります。
- このメソッドは、NTFS ファイルシステムでのみサポートされています。
- この方法では、十分な量の空きシステム メモリを確保する必要があります (オーバーレイの使用量と線形関係があります)。 呼び出しを完了するのに十分なメモリがない場合、メソッド呼び出しは失敗します。
- このメソッドでは、完了までにかなりの時間が必要になります (オーバーレイの使用量と指数関係があります)。
- このメソッドは、レジストリとファイルの除外およびコミットの両方で、一見関係のない操作によって影響を受けるファイルが表示される場合があります。
GetOverlayFiles メソッドを使用する場合は、次の項目にも注意する必要があります。
uwfmgr.exe file commit
コマンドでコミットされたファイルは、オーバーレイ ファイルの一覧にも含まれます。- 除外されたファイルは、オーバーレイ ファイルの一覧に含まれる場合があります。
- クラスター サイズより小さいファイル (ほとんどの場合は 4 KB など) は、オーバーレイにキャッシュされている場合でも一覧表示されません。
- 除外されるディレクトリ、除外されるファイル、または除外されるレジストリ項目の変更と削除は、オーバーレイの使用量に追加されます。
- ファイルとレジストリのコミットはオーバーレイの使用量に追加されます。
要件
Windows エディション | サポートされています |
---|---|
Windows Home | いいえ |
Windows Pro | いいえ |
Windows Enterprise | はい |
Windows Education | はい |
Windows IoT Enterprise | はい |