Поделиться через

код элемента управления FSCTL_SET_PERSISTENT_VOLUME_STATE

  • Статья

Код элемента управления FSCTL_SET_PERSISTENT_VOLUME_STATE задает постоянные параметры для тома файловой системы. Постоянные параметры остаются на томе файловой системы между перезагрузками компьютера.

Для выполнения этой операции вызовите FltFsControlFile или ZwFsControlFile со следующими параметрами.

Параметры

  • FileObject [in]: только FltFsControlFile . Указатель файлового объекта для тома файловой системы. Этот параметр является обязательным и не может иметь значение NULL.

  • FileHandle [in]: только ZwFsControlFile . Дескриптор файла для тома файловой системы. Этот параметр является обязательным и не может иметь значение NULL.

  • FsControlCode [in]: код элемента управления для операции. Для этой операции используйте FSCTL_SET_PERSISTENT_VOLUME_STATE .

  • InputBuffer [in]: указатель на структуру, выделенную вызывающим объектом FILE_FS_PERSISTENT_VOLUME_INFORMATION , которая содержит постоянные параметры для тома файловой системы.

  • InputBufferLength [in]: размер буфера в байтах, на который указывает параметр InputBuffer .

  • OutputBuffer [out]: не используется с этой операцией; задайте значение NULL.

  • OutputBufferLength [out]: не используется в этой операции; Значение равно нулю.

Блок состояния

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 , недостаточно велик для хранения данных постоянных параметров. В этом случае данные постоянных параметров не задаются. Это код ошибки.
STATUS_ACCESS_DENIED Вызывающий объект не может получить доступ к тому файловой системы.
STATUS_VOLUME_DISMOUNTED Том файловой системы отключен.
STATUS_TOO_LATE Том файловой системы завершает работу.
STATUS_MEDIA_WRITE_PROTECTED Том файловой системы доступен только для чтения.

Требования

Тип требования Требование
Минимальная версия клиента Windows 7
Заголовок Ntifs.h (включая Ntifs.h)

См. также раздел

FILE_FS_PERSISTENT_VOLUME_INFORMATION

FltFsControlFile

ZwFsControlFile