FSCTL_REMOVE_OVERLAY código de control

Artículo
03/14/2023

El código de control FSCTL_REMOVE_OVERLAY quita un origen de respaldo de un volumen.

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 obligatorio y no puede ser NULL.
FileObject [in]: FltFsControlFile solo. Objeto de puntero de archivo del volumen del que se quita la superposición. Este parámetro es obligatorio y no puede ser NULL.
FileHandle [in]: ZwFsControlFile solo. Identificador del volumen para el que se quita la superposición. Este parámetro es obligatorio y no puede ser NULL.
FsControlCode [in]: el código de control de la operación. Use FSCTL_REMOVE_OVERLAY para esta operación.
InputBuffer [in]: puntero al búfer de entrada, que debe contener una estructura WOF_EXTERNAL_INFO . Cuando sea necesario, los datos específicos del proveedor adicionales se incluyen inmediatamente después de WOF_EXTERNAL_INFO. Si el proveedor es un archivo WIM, se incluye una estructura de WIM_PROVIDER_REMOVE_OVERLAY_INPUT después de WOF_EXTERNAL_INFO.
InputBufferLength [in]: establézcalo en sizeof(WOF_EXTERNAL_INFO) más el tamaño de cualquier dato de entrada de proveedor adicional.
OutputBuffer [out]: no se usa. Definición en NULL
OutputBufferLength [in]: 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_ACCESS_DENIED	El solicitante no tiene privilegios administrativos.
STATUS_BUFFER_TOO_SMALL	La longitud del búfer de salida al que apunta OutputBuffer y especificado por OutputBufferLength es demasiado pequeño.
STATUS_INTERNAL_ERROR	No se puede acceder al volumen solicitado.
STATUS_INVALID_DEVICE_REQUEST	El servicio de respaldo no está presente o no se ha iniciado.

Comentarios

Cuando el origen de respaldo que se va a quitar es un archivo de Formato de imagen de Windows (WIM), el búfer de entrada contendrá una estructura de WOF_EXTERNAL_INFO seguida de una estructura de WIM_PROVIDER_REMOVE_OVERLAY_INPUT . InputBufferLength en este caso será sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_REMOVE_OVERLAY_INPUT). El valor dataSourceId de WIM_PROVIDER_REMOVE_OVERLAY_INPUT debe ser para un archivo WIM agregado previamente en una solicitud de FSCTL_ADD_OVERLAY .

Los proveedores de respaldo adicionales definirán sus propias estructuras de parámetros de entrada específicas.