FSCTL_DELETE_EXTERNAL_BACKING控制代码

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

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

参数

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

  • FileObject: [in]: FltFsControlFile only. 删除其后备关联的文件的文件指针对象。 此参数是必需的,不能为 NULL。

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

  • FsControlCode [in]:操作的控件代码。 对此操作使用 FSCTL_DELETE_EXTERNAL_BACKING

  • InputBuffer [in]:无。 设置为 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.hFltkernel.h)

另请参阅

FltFsControlFile

ZwFsControlFile

FSCTL_SET_EXTERNAL_BACKING