Compartir a través de


código de control de FSCTL_DELETE_EXTERNAL_BACKING

El código de control de 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]: FltFsControlFile solo. Puntero de instancia opaco para el autor de la llamada. Este parámetro es necesario 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 necesario 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 necesario y no puede ser NULL.

  • FsControlCode [in]: el código de control de la operación. Use FSCTL_DELETE_EXTERNAL_BACKING para esta operación.

  • InputBuffer [in]: None. Configúrelo en NULL.

  • InputBufferLength [in]: Se establece en 0.

  • OutputBuffer [out]: Ninguno. Configúrelo en NULL.

  • OutputBufferLength [out]: se establece 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.
ESTADO_ACCESO_DENEGADO El solicitante no tiene permiso para eliminar las asociaciones de respaldo del archivo.

Observaciones

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

Requisitos

Tipo de requisito Requisito
Cliente mínimo compatible Actualización de Windows 8.1
Cabecera Ntifs.h (incluya Ntifs.h o Fltkernel.h)

Consulte también

fltFsControlFile de

ZwFsControlFile

FSCTL_SET_EXTERNAL_BACKING