FSCTL_SET_PERSISTENT_VOLUME_STATE código de control
El código de control FSCTL_SET_PERSISTENT_VOLUME_STATE establece 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]: el código de control de la operación. Use FSCTL_SET_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 que contiene la configuración persistente de un volumen del sistema de archivos.
InputBufferLength [in]: tamaño, en bytes, del búfer al que apunta el parámetro InputBuffer .
OutputBuffer [out]: no se usa con esta operación; se establece en NULL.
OutputBufferLength [out]: No se usa con esta operación; se establece en cero.
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 | La configuración del Registro solicitada no es por volumen o 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 como para contener los datos de configuración persistente. En este caso, no se establece ningún dato 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) |