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

Структура 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

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

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-байтов).

Требования

   
Заголовок ntifs.h (include Ntifs.h, Fltkernel.h)

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

FltQueryVolumeInformation

FltSetVolumeInformation

IRP_MJ_QUERY_VOLUME_INFORMATION

IRP_MJ_SET_VOLUME_INFORMATION

ZwQueryVolumeInformationFile

ZwSetVolumeInformationFile