通过

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 参数指向非空列表，则忽略此参数。 此参数是可选的，可以为 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)
Library FltMgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

另请参阅

FILE_GET_QUOTA_INFORMATION

FltSetQuotaInformationFile

ZwQueryQuotaInformationFile