код элемента управления FSCTL_QUERY_PERSISTENT_VOLUME_STATE
Код элемента управления FSCTL_QUERY_PERSISTENT_VOLUME_STATE извлекает постоянные параметры для тома файловой системы. Постоянные параметры остаются на томе файловой системы между перезагрузками компьютера.
Для выполнения этой операции вызовите FltFsControlFile или ZwFsControlFile со следующими параметрами.
Параметры
FileObject [in]: только FltFsControlFile . Указатель файлового объекта для тома файловой системы. Этот параметр является обязательным и не может иметь значение NULL.
FileHandle [in]: только ZwFsControlFile . Дескриптор файла для тома файловой системы. Этот параметр является обязательным и не может иметь значение NULL.
FsControlCode [in]: код элемента управления для операции. Используйте FSCTL_QUERY_PERSISTENT_VOLUME_STATE для этой операции.
InputBuffer [in]: указатель на структуру, выделенную вызывающим объектом FILE_FS_PERSISTENT_VOLUME_INFORMATION .
InputBufferLength [in]: размер (в байтах) буфера, на который указывает параметр InputBuffer .
OutputBuffer [out]: указатель на структуру, выделенную вызывающим объектом FILE_FS_PERSISTENT_VOLUME_INFORMATION , которая получает постоянные параметры для тома файловой системы.
OutputBufferLength [out]: размер в байтах буфера, на который указывает параметр OutputBuffer .
Блок состояния
FltFsControlFile или ZwFsControlFile возвращает STATUS_SUCCESS или соответствующее значение NTSTATUS, например одно из следующих значений:
| Код | Значение |
|---|---|
| STATUS_NOT_SUPPORTED | Вызывающий объект указал неправильный номер версии в элементе VersionFILE_FS_PERSISTENT_VOLUME_INFORMATION. |
| STATUS_INVALID_PARAMETER | Том файловой системы не является открытым томом пользователя или вызывающий объект указал недопустимый флаг в элементе FlagMaskFILE_FS_PERSISTENT_VOLUME_INFORMATION. |
| STATUS_BUFFER_TOO_SMALL | Буфер, на который указывает параметр InputBuffer , недостаточно велик (то есть буфер меньше , чем sizeof(FILE_FS_PERSISTENT_VOLUME_INFORMATION)). В этом случае данные постоянных параметров не возвращаются. Это код ошибки. |
| STATUS_ACCESS_DENIED | Вызывающий объект не может получить доступ к тому файловой системы. |
| STATUS_VOLUME_DISMOUNTED | Том файловой системы отключен. |
| STATUS_TOO_LATE | Работа тома файловой системы завершается. |
| STATUS_MEDIA_WRITE_PROTECTED | Том файловой системы доступен только для чтения. |
Требования
| Тип требования | Требование |
|---|---|
| Минимальная версия клиента | Windows 7 |
| Заголовок | Ntifs.h (включая Ntifs.h или Fltkernel.h) |