структура 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 | Если задано, файловая система перестраивает сведения о квоте для тома. |
Кроме того, определены следующие маски флагов. Это полезно для тестирования значений флагов.
| Маска | Ценность |
|---|---|
| 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) |