FSCTL_UPDATE_OVERLAY código de control
El código de control FSCTL_UPDATE_OVERLAY actualiza un nuevo identificador de origen de datos para un origen de respaldo asociado a 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 para el que se actualiza la superposición. Este parámetro es obligatorio y no puede ser NULL.
FileHandle [in]: ZwFsControlFile solo. Identificador del volumen para el que se actualiza 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_UPDATE_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_UPDATE_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 entrada al que apunta InputBuffer y especificado por InputBufferLength 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 datos que se va a actualizar 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_UPDATE_OVERLAY_INPUT . InputBufferLength en este caso será sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_UPDATE_OVERLAY_INPUT). El valor DataSourceId de WIM_PROVIDER_UPDATE_OVERLAY_INPUT debe ser para un archivo WIM agregado previamente en una solicitud de FSCTL_ADD_OVERLAY .
Otros proveedores de respaldo definirán sus propias estructuras de parámetros de entrada específicas.
Requisitos
| Tipo de requisito | Requisito |
|---|---|
| Cliente mínimo compatible | Windows 8.1 Update |
| Encabezado | Ntifs.h (incluya Ntifs.h o Fltkernel.h) |