通过

FltQueryQuotaInformationFile 函数 （fltkernel.h）

  • 项目

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的调用结果。 如果调用因 SID 列表无效而失败，则 信息 字段将包含发生错误的 SidList 中的位置。

[out] Buffer

指向要返回配额信息值的调用方提供的 FILE_GET_QUOTA_INFORMATION结构化输入缓冲区的指针。

[in] Length

Buffer 参数指向的缓冲区的长度（以字节为单位）。

[in] ReturnSingleEntry

如果 FltQueryQuotaInformationFile 应仅返回找到的第一个条目，则设置为 TRUE。

[in, optional] SidList

指向调用方提供的 FILE_GET_QUOTA_INFORMATION结构化输入缓冲区的指针，该缓冲区指定要查询的配额信息。 此参数是可选的，可以 NULL。

[in] SidListLength

SidList 参数指向的缓冲区的长度（以字节为单位）。

[in, optional] StartSid

开始扫描文件的配额信息列表的条目的索引。 如果 SidList 参数指向 nonempty 列表，则忽略此参数。 此参数是可选的，可以 NULL。

[in] RestartScan

如果 FltQueryQuotaInformationFile 应在文件配额信息列表中的第一个条目处开始扫描，则设置为 TRUE。 如果未将此参数设置为 TRUE，则会从对 FltQueryQuotaInformationFile的上一次调用恢复扫描。

[out, optional] LengthReturned

指向调用方分配的变量的指针，该变量接收 Buffer中返回的信息的大小（以字节为单位）。 此参数是可选的，可以 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