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

Статья
02/06/2025

Программа FltQueryQuotaInformationFile извлекает записи квоты, связанные с объектом файла.

Синтаксис

NTSTATUS FLTAPI FltQueryQuotaInformationFile(
  [in]            PFLT_INSTANCE    Instance,
  [in]            PFILE_OBJECT     FileObject,
  [out]           PIO_STATUS_BLOCK IoStatusBlock,
  [out]           PVOID            Buffer,
  [in]            ULONG            Length,
  [in]            BOOLEAN          ReturnSingleEntry,
  [in, optional]  PVOID            SidList,
  [in]            ULONG            SidListLength,
  [in, optional]  PULONG           StartSid,
  [in]            BOOLEAN          RestartScan,
  [out, optional] PULONG           LengthReturned
);

Параметры

[in] Instance

Непрозрачный указатель экземпляра вызывающего объекта. Этот параметр является обязательным и не может быть null.

[in] FileObject

Указатель на объект файла для открытого файла, каталога, устройства хранения или тома. Этот параметр является обязательным и не может быть null.

[out] IoStatusBlock

Вызывающий IO_STATUS_BLOCK для получения результата вызова FltQueryQuotaInformationFile. Если вызов завершается ошибкой из-за недопустимого списка идентификатора безопасности, поле сведений будет содержать расположение в SidList, где произошла ошибка.

[out] Buffer

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

[in] Length

Длина буфера в байтах, на который указывает параметр буфера.

[in] ReturnSingleEntry

Задайте значение TRUE, если FltQueryQuotaInformationFile должен возвращать только первую запись, найденную.

[in, optional] SidList

Указатель на предоставленный вызывающим FILE_GET_QUOTA_INFORMATIONструктурированный входной буфер, указывающий сведения о квоте, запрашиваемые. Этот параметр является необязательным и может быть null.

[in] SidListLength

Длина буфера в байтах, на который указывает параметр SidList.

[in, optional] StartSid

Индекс записи, с которой начинается сканирование списка сведений о квоте файла. Этот параметр игнорируется, если параметр SidList указывает на список nonempty. Этот параметр является необязательным и может быть null.

[in] RestartScan

Установите значение TRUE, если FltQueryQuotaInformationFile должен начать сканирование при первой записи в списке сведений о квотах файла. Если для этого параметра не задано значение TRUE, проверка возобновляется с предыдущего вызова FltQueryQuotaInformationFile.

[out, optional] LengthReturned

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

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

FltQueryQuotaInformationFile возвращает STATUS_SUCCESS или соответствующее значение NTSTATUS, например следующее.

Возвращаемый код	Описание
STATUS_FLT_DELETING_OBJECT	Экземпляр или том отключается. Это код ошибки.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 8.
целевая платформа	Всеобщий
заголовка	fltkernel.h (include Fltkernel.h)
библиотеки	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL

См. также

FILE_GET_QUOTA_INFORMATION

FltSetQuotaInformationFile

ZwQueryQuotaInformationFile

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