FSCTL_DELETE_EXTERNAL_BACKING控制代码
FSCTL_DELETE_EXTERNAL_BACKING控制代码会删除文件与外部支持提供程序(包括 Windows 映像格式 (WIM) 提供程序或压缩文件提供程序)的关联。 由于此操作,备份文件的全部内容将被读取、解压缩并写入文件中。
若要执行此操作,请使用以下参数调用 FltFsControlFile 或 ZwFsControlFile 。
参数
实例 [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。
状态块
如果操作成功,FltFsControlFile 或 ZwFsControlFile 将返回STATUS_SUCCESS。 否则,相应的函数可能会返回以下 NTSTATUS 值之一。
代码 | 含义 |
---|---|
STATUS_OBJECT_NOT_EXTERNALLY_BACKED | 文件不受外部支持。 |
STATUS_INVALID_DEVICE_REQUEST | 支持服务不存在或未启动。 |
STATUS_ACCESS_DENIED | 请求者无权删除文件的后备关联。 |
注解
由于执行删除操作,将从后备源读取文件的内容,并将整个文件写入卷。
要求
要求类型 | 要求 |
---|---|
最低受支持的客户端 | Windows 8.1 更新 |
标头 | Ntifs.h (包括 Ntifs.h 或 Fltkernel.h) |