FSCTL_DELETE_EXTERNAL_BACKING 制御コード

FSCTL_DELETE_EXTERNAL_BACKING 制御コードは、Windows Image Format (WIM) プロバイダーや圧縮ファイル プロバイダーなど、外部バッキング プロバイダーとのファイルの関連付けを削除します。 この操作の結果、バックアップされたファイルの内容全体が読み取られ、圧縮解除されて、ファイルに書き込まれます。

この操作を実行するには、次のパラメーターを指定して FltFsControlFile または ZwFsControlFile を呼び出します。

パラメーター

• インスタンス [in]: FltFsControlFile のみ。 呼び出し元の不透明なインスタンス ポインター。 このパラメーターは必須であり、NULL にすることはできません。

• FileObject [in]: FltFsControlFile のみ。 バッキング関連付けが削除されるファイルのファイル ポインター オブジェクト。 このパラメーターは必須であり、NULL にすることはできません。

• FileHandle [in]: ZwFsControlFile のみ。 バッキング関連付けが削除されるファイルのハンドル。 このパラメーターは必須であり、NULL にすることはできません。

• FsControlCode [in]: 操作の制御コード。 この操作には FSCTL_DELETE_EXTERNAL_BACKING を使用します。

• InputBuffer [in]: なし。 NULL に設定されている。

• InputBufferLength [in]: 0 に設定します。

• OutputBuffer [out]: なし。 NULL に設定されている。

• OutputBufferLength [out]: 0 に設定します。

ステータスブロック

FltFsControlFile または ZwFsControlFile は、操作が成功した場合に STATUS_SUCCESS を返します。 それ以外の場合は、適切な関数から次の NTSTATUS 値のいずれかが返される可能性があります。

コード	意味
STATUS_OBJECT_NOT_EXTERNALLY_BACKED	ファイルは外部でバックアップされていません。
STATUS_INVALID_DEVICE_REQUEST	バッキング サービスが存在しないか、開始されていません。
STATUS_ACCESS_DENIED	要求者には、ファイルのバッキング関連付けを削除する権限がありません。

解説

削除操作の結果、ファイルの内容がバッキング ソースから読み取られ、ファイル全体がボリュームに書き込まれます。

要件

要件タイプ	要件
サポートされている最小のクライアント	Windows 8.1 Update
ヘッダー	Ntifs.h (Ntifs.h または Fltkernel.h を含む)

関連項目

FltFsControlFile

ZwFsControlFile

FSCTL_SET_EXTERNAL_BACKING