FSCTL_ENUM_OVERLAY código de control
El código de control FSCTL_ENUM_OVERLAY enumera todos los orígenes de datos de un proveedor de respaldo para un volumen especificado.
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 que especifica el volumen que se va a desmontar. Este parámetro es obligatorio y no puede ser NULL.
FileHandle [in]: ZwFsControlFile solo. Identificador de archivo del volumen que se va a desmontar. Este parámetro es obligatorio y no puede ser NULL.
FsControlCode [in]: Código de control para la operación. Use FSCTL_REMOVE_OVERLAY para esta operación.
InputBuffer [in]: puntero al búfer de entrada, que debe contener una estructura de WOF_EXTERNAL_INFO .
InputBufferLength [in]: Establezca en sizeof(WOF_EXTERNAL_INFO).
OutputBuffer [out]: puntero a un búfer de salida que recibirá una o varias estructuras de WIM_PROVIDER_OVERLAY_ENTRY para orígenes de datos que respaldan el volumen.
OutputBufferLength [out]: Tamaño del búfer al que apunta OutputBuffer, en bytes.
LengthReturned [out]: especifica el número de bytes escritos en OutputBuffer al completarse correctamente.
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 especificada por OutputBufferLength es demasiado pequeña. |
| STATUS_INTERNAL_ERROR | El volumen solicitado no es accesible. |
| STATUS_INVALID_DEVICE_REQUEST | El servicio de respaldo no está presente o no se ha iniciado. |
Comentarios
Al enumerar los orígenes de datos para el proveedor WIM, el búfer de salida contendrá una matriz de estructuras de WIM_PROVIDER_OVERLAY_ENTRY . El tamaño del búfer de salida debe ser lo suficientemente grande como para contener todas las entradas de superposición o la llamada devolverá STATUS_BUFFER_TOO_SMALL.
Los proveedores de respaldo adicionales definirán sus propias estructuras de enumeración específicas.
Requisitos
| Tipo de requisito | Requisito |
|---|---|
| Cliente mínimo compatible | Windows 8.1 Update |
| Encabezado | Ntifs.h (incluya Ntifs.h o Fltkernel.h) |