Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 necesario 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 necesario y no puede ser NULL.
FileHandle [in]: ZwFsControlFile solo. Identificador del volumen para el que se quita la superposición. Este parámetro es necesario 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, se incluyen datos específicos del proveedor adicionales 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]: Establezca en sizeof(WOF_EXTERNAL_INFO) más el tamaño de los datos de entrada del proveedor adicionales.
OutputBuffer [out]: No se usa. Configúrelo en NULL.
OutputBufferLength [in]: 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 |
|---|---|
| ESTADO_ACCESO_DENEGADO | 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. |
| ERROR_INTERNO_DEL_SISTEMA | No se puede acceder al volumen solicitado. |
| STATUS_INVALID_DEVICE_REQUEST | El servicio de respaldo no está presente o no se ha iniciado. |
Observaciones
Cuando el origen de respaldo que se va a quitar es un archivo de formato de imágenes 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.
Requisitos
| Tipo de requisito | Requisito |
|---|---|
| Cliente mínimo compatible | Actualización de Windows 8.1 |
| Cabecera | Ntifs.h (incluya Ntifs.h o Fltkernel.h) |