Функция FltSetVolumeInformation (fltkernel.h)

Статья
02/26/2024

FltSetVolumeInformation изменяет различные типы сведений о томе, к которому присоединен данный экземпляр.

Синтаксис

NTSTATUS FLTAPI FltSetVolumeInformation(
  [in]  PFLT_INSTANCE        Instance,
  [out] PIO_STATUS_BLOCK     Iosb,
  [out] PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

Параметры

[in] Instance

Указатель непрозрачного экземпляра для экземпляра драйвера минифильтра, подключенного к тому.

[out] Iosb

Указатель на структуру IO_STATUS_BLOCK, которая получает окончательное состояние завершения и сведения об операции.

[out] FsInformation

Указатель на буфер, выделенный вызывающим объектом, содержащий значения, которые необходимо задать для тома. Структура сведений, содержащихся в буфере, определяется параметром FsInformationClass .

[in] Length

Размер буфера, на который указывает FsInformation, в байтах . Вызывающий объект должен задать этот параметр в соответствии с заданным FsInformationClass. Например, если fsInformationClass имеет значение FileFsControlInformation, длина должна быть не менее sizeof(FILE_FS_CONTROL_INFORMATION).

[in] FsInformationClass

Тип сведений для тома. Один из следующих вариантов.

Значение	Значение
FileFsControlInformation	Задайте FILE_FS_CONTROL_INFORMATION для тома.
FileFsLabelInformation	Задайте FILE_FS_LABEL_INFORMATION для тома.
FileFsObjectIdInformation	Задайте FILE_FS_OBJECTID_INFORMATION для тома.

Возвращаемое значение

FltSetVolumeInformation возвращает STATUS_SUCCESS или соответствующее значение NTSTATUS, например одно из следующих значений:

Код возврата	Описание
STATUS_INFO_LENGTH_MISMATCH	Для параметра Length задано недопустимое значение. Это код ошибки.
STATUS_INSUFFICIENT_RESOURCES	FltSetVolumeInformation столкнулся с ошибкой выделения пула. Это код ошибки.
STATUS_INVALID_INFO_CLASS	Для FsInformationClass указано недопустимое значение. Это код ошибки.
STATUS_INVALID_PARAMETER	Экземпляр подключен к сетевому тому. FltSetVolumeInformation нельзя использовать для задания сведений о томе сети. Это код ошибки.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	fltkernel.h (включая Fltkernel.h)
Библиотека	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL

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

FILE_FS_CONTROL_INFORMATION

FILE_FS_LABEL_INFORMATION

FILE_FS_OBJECTID_INFORMATION

FltQueryVolumeInformation

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