FSCTL_DELETE_EXTERNAL_BACKING控制代码

FSCTL_DELETE_EXTERNAL_BACKING代码删除文件与外部支持提供程序(包括 WIM 提供程序或压缩文件提供程序Windows映像格式 (WIM) 的关联。 由于此操作,将读取、解压缩和写入所支持文件的全部内容。

若要执行此操作,请通过以下参数调用 FltFsControlFileZwFsControlFile

Parameters

实例 [in]
仅 FltFsControlFile 。 调用方的不透明实例指针。 此参数是必需的,不能为 NULL。

FileObject [in]
仅 FltFsControlFile 。 要删除其支持关联的文件的文件指针对象。 此参数是必需的,不能为 NULL。

FileHandle [in]
仅 ZwFsControlFile 。 要删除其支持关联的文件的句柄。 此参数是必需的,不能为 NULL。

FsControlCode [in]
操作的控制代码。 使用 FSCTL_DELETE_EXTERNAL_BACKING 执行该操作。

InputBuffer
无。 设置为 NULL。

InputBufferLength [in]
设置为 0。

OutputBuffer [out]
无。 设置为 NULL。

OutputBufferLength [out]
设置为 0。

状态块

如果操作成功,FltFsControlFileZwFsControlFile STATUS_SUCCESS返回 。 否则,相应的函数可能会返回以下 NTSTATUS 值之一。

术语 说明

STATUS_OBJECT_NOT_EXTERNALLY_BACKED

文件不由外部支持。

STATUS_INVALID_DEVICE_REQUEST

支持服务不存在或尚未启动。

STATUS_ACCESS_DENIED

请求者无权删除文件的后备关联。

备注

由于执行删除操作,文件的内容将从后备源读取,整个文件将写入卷。

要求

版本

从 Windows 8.1 更新 开始可用。

标头

Ntifs.h (包括 Ntifs.h 或 Fltkernel.h)

另请参阅

FltFsControlFile

ZwFsControlFile

FSCTL_SET_EXTERNAL_BACKING