структура FILE_FS_CONTROL_INFORMATION (ntifs.h)

Статья
01/10/2024

Структура FILE_FS_CONTROL_INFORMATION используется для запроса или задания сведений об элементах управления для файлов в каталоге.

Синтаксис

typedef struct _FILE_FS_CONTROL_INFORMATION {
  LARGE_INTEGER FreeSpaceStartFiltering;
  LARGE_INTEGER FreeSpaceThreshold;
  LARGE_INTEGER FreeSpaceStopFiltering;
  LARGE_INTEGER DefaultQuotaThreshold;
  LARGE_INTEGER DefaultQuotaLimit;
  ULONG         FileSystemControlFlags;
} FILE_FS_CONTROL_INFORMATION, *PFILE_FS_CONTROL_INFORMATION;

Члены

FreeSpaceStartFiltering

Минимальный объем свободного места на диске (в байтах), необходимый для начала фильтрации документов с помощью управляющей программы Content-Indexing.

FreeSpaceThreshold

Минимальный объем свободного места на диске в байтах, необходимый службе индексирования для фильтрации документов и объединения списков слов. Если объем свободного места на диске ниже этого порогового значения, в журнал событий приложений Microsoft Windows записывается предупреждающее сообщение. Фильтрация и слияние приостанавливаются до освобождения пространства.

FreeSpaceStopFiltering

Минимальный объем свободного места на диске (в байтах), необходимый для продолжения фильтрации документов с помощью управляющей программы индексирования содержимого. Если объем свободного места на диске ниже этого порогового значения, фильтрация документов останавливается.

DefaultQuotaThreshold

Пороговое значение предупреждения о квоте на диск по умолчанию для каждого пользователя для тома.

DefaultQuotaLimit

Квота диска по умолчанию для каждого пользователя для тома.

FileSystemControlFlags

Битовая маска флагов, управляющих применением квоты и ведением журнала событий квоты, связанных с пользователем, на томе. Ведение журнала делает запись в журнале событий приложений Windows. Совместимое сочетание одного или нескольких из следующих компонентов:

Флаг элемента управления файловой системой	Значение
FILE_VC_CONTENT_INDEX_DISABLED	Если задано значение , индексирование содержимого отключено.
FILE_VC_LOG_QUOTA_LIMIT	Если задано значение , запись журнала событий будет создана, когда пользователь превысит установленное ограничение дисковой квоты.
FILE_VC_LOG_QUOTA_THRESHOLD	Если задано значение , запись журнала событий будет создана, когда пользователь превысит порог предупреждения о назначенной квоте.
FILE_VC_LOG_VOLUME_LIMIT	Если задано значение , запись журнала событий будет создана при превышении ограничения свободного пространства тома.
FILE_VC_LOG_VOLUME_THRESHOLD	Если задано значение , запись журнала событий будет создана при превышении порогового значения свободного места тома.
FILE_VC_QUOTA_ENFORCE	Если задано значение , квоты применяются к тому.
FILE_VC_QUOTA_TRACK	Если задано значение , квоты отслеживаются на томе.
FILE_VC_QUOTAS_INCOMPLETE	Если задано значение , сведения о квоте для тома будут неполными.
FILE_VC_QUOTAS_REBUILDING	Если этот параметр задан, файловая система перестраивает сведения о квоте для тома.

Кроме того, определены следующие маски флагов. Они полезны для тестирования значений флагов.

Mask	Значение
FILE_VC_QUOTA_MASK	FILE_VC_QUOTA_ENFORCE \| FILE_VC_QUOTA_TRACK
FILE_VC_QUOTA_NONE	~FILE_VC_QUOTA_ENFORCE & ~FILE_VC_QUOTA_TRACK
FILE_VC_VALID_MASK	ORed сочетание всех флагов в приведенной выше таблице.

Вызовите FltQueryVolumeInformation или ZwQueryVolumeInformationFile, передав FileFsControlInformation в качестве значения FileInformationClass и передавая выделенный вызывающим FILE_FS_CONTROL_INFORMATION структурированный буфер в качестве значения FileInformation.
Создайте IRP с основным кодом функции IRP_MJ_QUERY_VOLUME_INFORMATION.

FILE_READ_DATA для запроса этой информации требуется доступ к тому.

Эти сведения можно задать с помощью любого из следующих способов:

Вызовите FltSetVolumeInformation или ZwSetVolumeInformationFile, передав FileFsControlInformation в качестве значения FileInformationClass и передавая выделенный вызывающим FILE_FS_CONTROL_INFORMATION структурированный буфер в качестве значения FileInformation.
Создайте IRP с основным кодом функции IRP_MJ_SET_VOLUME_INFORMATION.

FILE_WRITE_DATA для установки этих сведений требуется доступ к тому.

Размер буфера, передаваемого в параметре FileInformation в FltQueryVolumeInformation, FltSetVolumeInformation, ZwQueryVolumeInformationFile или ZwSetVolumeInformationFile , должен быть не меньше размера (FILE_FS_CONTROL_INFORMATION).

Эта структура должна быть выровнена по границе LONGLONG (8 байт).