FSCTL_GET_EXTERNAL_BACKING código de control

Artículo
03/14/2023

El código de control FSCTL_GET_EXTERNAL_BACKING obtiene la información de respaldo de un archivo de un proveedor de respaldo externo. Los proveedores de respaldo incluyen el proveedor de Formato de imagen de Windows (WIM) o el proveedor de archivos comprimidos individuales. El contenido de los archivos respaldados externamente puede residir en volúmenes distintos del volumen que contiene el archivo consultado.

Para realizar esta operación, llame a FltFsControlFile o ZwFsControlFile con los parámetros siguientes.

Parámetros

Instancia [in]: Solo FltFsControlFile . Puntero de instancia opaco para el autor de la llamada. Este parámetro es obligatorio y no puede ser NULL.
FileObject [in]: FltFsControlFile solo. Objeto de puntero de archivo del archivo para el que se consulta la información de respaldo. Este parámetro es obligatorio y no puede ser NULL.
FileHandle [in]: ZwFsControlFile solo. Identificador del archivo para el que se consulta la información de respaldo. Este parámetro es obligatorio y no puede ser NULL.
FsControlCode [in]: código de control para la operación. Use FSCTL_GET_EXTERNAL_BACKING para esta operación.
InputBuffer [in]: Ninguno. Se establece en NULL.
InputBufferLength [in]: Establezca en 0.
OutputBuffer [out]: puntero al búfer de salida, que debe tener un tamaño lo suficientemente grande como para recibir una estructura de WOF_EXTERNAL_INFO seguida de los datos del proveedor. En el caso de los archivos respaldados por WIM, WOF_EXTERNAL_INFO va seguido de una estructura de WIM_PROVIDER_EXTERNAL_INFO . En el caso de los archivos comprimidos individualmente, WOF_EXTERNAL_INFO va seguido de una estructura de FILE_PROVIDER_EXTERNAL_INFO_V1 .
OutputBufferLength [out]: Tamaño, en bytes, del búfer al que apunta OutputBuffer.
LengthReturned [out]: especifica el número de bytes escritos en OutputBuffer al completarse correctamente.

Bloque de estado

FltFsControlFile o ZwFsControlFile devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, la función adecuada podría devolver uno de los siguientes valores NTSTATUS.

Código	Significado
STATUS_OBJECT_NOT_EXTERNALLY_BACKED	El archivo no está respaldado externamente.
STATUS_INVALID_DEVICE_REQUEST	El servicio de respaldo no está presente o no se ha iniciado.

Comentarios

Cuando el proveedor de respaldo del origen de datos que se va a actualizar es un archivo WIM, el búfer de salida contendrá una estructura de WOF_EXTERNAL_INFO seguida de una estructura de WIM_PROVIDER_EXTERNAL_INFO . OutputBufferLength debe tener al menos sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_EXTERNAL_INFO). Cuando el proveedor de respaldo es un archivo comprimido individualmente, el búfer de salida contendrá una estructura de WOF_EXTERNAL_INFO seguida de una estructura de FILE_PROVIDER_EXTERNAL_INFO_V1 .