FSCTL_DELETE_EXTERNAL_BACKING código de control

  • Artículo

El código de control FSCTL_DELETE_EXTERNAL_BACKING quita la asociación de un archivo con un proveedor de respaldo externo, incluido el proveedor de formato de imagen de Windows (WIM) o el proveedor de archivos comprimidos. Como resultado de esta operación, todo el contenido de un archivo respaldado se lee, descomprime y escribe en el archivo.

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 elimina la asociación de respaldo. Este parámetro es obligatorio y no puede ser NULL.

  • FileHandle [in]: ZwFsControlFile solo. Identificador del archivo para el que se elimina la asociació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_DELETE_EXTERNAL_BACKING para esta operación.

  • InputBuffer [in]: Ninguno. Definición en NULL

  • InputBufferLength [in]: Establezca en 0.

  • OutputBuffer [out]: Ninguno. Definición en NULL

  • OutputBufferLength [out]: establezca en 0.

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.
STATUS_ACCESS_DENIED El solicitante no tiene permiso para eliminar las asociaciones de respaldo del archivo.

Comentarios

Como resultado de la operación de eliminación, el contenido del archivo se lee desde el origen de respaldo y todo el archivo se escribe en el volumen.

Requisitos

Tipo de requisito Requisito
Cliente mínimo compatible Windows 8.1 Update
Encabezado Ntifs.h (incluya Ntifs.h o Fltkernel.h)

Consulte también

FltFsControlFile

ZwFsControlFile

FSCTL_SET_EXTERNAL_BACKING