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

Статья
08/07/2023

Подпрограмма 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

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

[in] ReturnSingleEntry

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

[in, optional] SidList

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

[in] SidListLength

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

[in, optional] StartSid

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

[in] RestartScan

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

[out, optional] LengthReturned

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

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

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

Код возврата	Описание
STATUS_FLT_DELETING_OBJECT	Экземпляр или том сносится. Это код ошибки.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 8.
Целевая платформа	Универсальное
Верхняя часть	fltkernel.h (включая Fltkernel.h)
Библиотека	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL

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

FILE_GET_QUOTA_INFORMATION

FltSetQuotaInformationFile

ZwQueryQuotaInformationFile

Share via