FSCTL_GET_EXTERNAL_BACKING控制代码

控制 FSCTL_GET_EXTERNAL_BACKING 代码从外部支持提供程序获取文件的后备信息。 支持提供程序包括 WIM Windows或 (压缩) 提供程序的映像格式。 外部支持的文件的内容可能驻留在包含所查询文件的卷上的卷上。

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

Parameters

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

FileObject [in]
仅 FltFsControlFile 。 查询其支持信息的文件的文件指针对象。 此参数是必需的,不能为 NULL。

FileHandle [in]
仅 ZwFsControlFile 。 查询其支持信息的文件的句柄。 此参数是必需的,不能为 NULL。

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

InputBuffer [in]
无。 设置为 NULL

InputBufferLength [in]
设置为 0。

OutputBuffer [out]
指向输出缓冲区的指针,该缓冲区的大小必须足够大,以接收 WOF_EXTERNAL_INFO后跟 提供程序数据的结构。 对于 WIM 支持 的文件,WOF_EXTERNAL_INFO跟一个 WIM_PROVIDER_EXTERNAL_INFO结构。 对于单独压缩 的文件,WOF_EXTERNAL_INFO跟一个 FILE_PROVIDER_EXTERNAL_INFO_V1结构。

OutputBufferLength [out]
OutputBuffer 指向的缓冲区的大小(以字节为单位)。

LengthRe以
指定成功完成时写入 OutputBuffer 的字节数。

状态块

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

术语 说明

STATUS_OBJECT_NOT_EXTERNALLY_BACKED

文件不由外部支持。

STATUS_INVALID_DEVICE_REQUEST

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

备注

当要更新的数据源的支持提供程序是 WIM 文件时,输出缓冲区将包含一个 WOF_EXTERNAL_INFO结构, WIM_PROVIDER_EXTERNAL_INFO结构。 OutputBufferLength 必须至少为 (WOF_EXTERNAL_INFO) + sizeof (WIM_PROVIDER_EXTERNAL_INFO) 当支持提供程序是单个压缩文件时,输出缓冲区将包含一个 WOF_EXTERNAL_INFO结构,跟FILE_PROVIDER_EXTERNAL_INFO_V1结构

要求

版本

从 Windows 8.1 更新 开始可用。

标头

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

另请参阅

FltFsControlFile

ZwFsControlFile

FSCTL_SET_EXTERNAL_BACKING

WIM_PROVIDER_EXTERNAL_INFO

WOF_EXTERNAL_INFO