структура 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
Минимальный объем свободного места на диске (в байтах), необходимый для начала фильтрации документов с помощью управляющей программы 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 байт).
Требования
| Требование | Значение |
|---|---|
| Заголовок | ntifs.h (включая Ntifs.h, Fltkernel.h) |