FSCTL_QUERY_PERSISTENT_VOLUME_STATE código de control
El código de control FSCTL_QUERY_PERSISTENT_VOLUME_STATE recupera la configuración persistente de un volumen del sistema de archivos. La configuración persistente permanece en un volumen del sistema de archivos entre reinicios del equipo.
Para realizar esta operación, llame a FltFsControlFile o ZwFsControlFile con los parámetros siguientes.
Parámetros
FileObject [in]: FltFsControlFile solo. Puntero de objeto de archivo para el volumen del sistema de archivos. Este parámetro es obligatorio y no puede ser NULL.
FileHandle [in]: ZwFsControlFile solo. Identificador de archivo para el volumen del sistema de archivos. Este parámetro es obligatorio y no puede ser NULL.
FsControlCode [in]: código de control para la operación. Use FSCTL_QUERY_PERSISTENT_VOLUME_STATE para esta operación.
InputBuffer [in]: puntero a una estructura de FILE_FS_PERSISTENT_VOLUME_INFORMATION asignada por el autor de la llamada.
InputBufferLength [in]: tamaño, en bytes, del búfer al que apunta el parámetro InputBuffer .
OutputBuffer [out]: puntero a una estructura de FILE_FS_PERSISTENT_VOLUME_INFORMATION asignada por el autor de la llamada que recibe la configuración persistente de un volumen del sistema de archivos.
OutputBufferLength [out]: tamaño, en bytes, del búfer al que apunta el parámetro OutputBuffer .
Bloque de estado
FltFsControlFile o ZwFsControlFile devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como uno de los siguientes:
| Código | Significado |
|---|---|
| STATUS_NOT_SUPPORTED | El autor de la llamada especificó un número de versión incorrecto en el miembro Version de FILE_FS_PERSISTENT_VOLUME_INFORMATION. |
| STATUS_INVALID_PARAMETER | El volumen del sistema de archivos no es un volumen de usuario abierto o el autor de la llamada especificó una marca no válida en el miembro FlagMask de FILE_FS_PERSISTENT_VOLUME_INFORMATION. |
| STATUS_BUFFER_TOO_SMALL | El búfer al que apunta el parámetro InputBuffer no es lo suficientemente grande (es decir, el búfer es menor que sizeof(FILE_FS_PERSISTENT_VOLUME_INFORMATION)). En este caso, no se devuelven datos de configuración persistente. Se trata de un código de error. |
| STATUS_ACCESS_DENIED | El autor de la llamada no puede acceder al volumen del sistema de archivos. |
| STATUS_VOLUME_DISMOUNTED | El volumen del sistema de archivos se desmonta. |
| STATUS_TOO_LATE | El volumen del sistema de archivos se apaga. |
| STATUS_MEDIA_WRITE_PROTECTED | El volumen del sistema de archivos es de solo lectura. |
Requisitos
| Tipo de requisito | Requisito |
|---|---|
| Cliente mínimo compatible | Windows 7 |
| Encabezado | Ntifs.h (incluya Ntifs.h o Fltkernel.h) |