MRxQueryQuotaInfo 例程

项目
02/07/2024

RDBSS 调用 MRxQueryQuotaInfo 例程来请求网络微型重定向程序查询文件系统对象上的配额信息。

语法

PMRX_CALLDOWN MRxQueryQuotaInfo;

NTSTATUS MRxQueryQuotaInfo(
  _Inout_ PRX_CONTEXT RxContext
)
{ ... }

参数

RxContext [in， out]
指向RX_CONTEXT 结构的指针。此参数包含请求操作的 IRP。

返回值

MRxQueryQuotaInfo 在成功时返回STATUS_SUCCESS或适当的 NTSTATUS 值，例如以下值之一：

返回代码	说明
STATUS_ACCESS_DENIED	调用方对此操作缺乏适当的安全性。
STATUS_BUFFER_OVERFLOW	用于接收配额信息的缓冲区太小。应将此返回值视为成功，并且应在 RxContext 参数指向的 RX_CONTEXT 结构的 Info.Buffer 成员中返回尽可能多的有效数据。
STATUS_BUFFER_TOO_SMALL	缓冲区太小，无法接收请求的数据。如果返回此值，则应将 RxContext 参数指向的 RX_CONTEXT 结构的 InformationToReturn 成员设置为预期缓冲区的最小大小，以便调用成功。
STATUS_CONNECTION_DISCONNECTED	连接已断开连接。这是错误代码。
STATUS_INSUFFICIENT_RESOURCES	资源不足，无法完成查询。这是错误代码。
STATUS_INVALID_PARAMETER	指定的参数无效。这是错误代码。
STATUS_NOT_SUPPORTED	不支持配额。

注解

RDBSS 发出对 MRxQueryQuotaInfo 的调用，以响应接收 IRP_MJ_QUERY_QUOTA 请求。

在调用 MRxQueryQuotaInfo 之前，RDBSS 修改 RxContext 参数指向的 RX_CONTEXT 结构中的以下成员：

Info.Buffer 成员设置为 I/O 请求数据包中的用户缓冲区。如果需要，RDBSS 已锁定此缓冲区。

Info.LengthRemaining 成员设置为 IrpSp-Parameters.QueryQuota.Length>。

QueryQuota.SidList 成员设置为 IrpSp-Parameters.QueryQuota.SidList>。

QueryQuota.SidListLength 成员设置为 IrpSp-Parameters.QueryQuota.SidListLength>。

QueryQuota.StartSid 成员设置为 IrpSp-Parameters.QueryQuota.StartSid>。

QueryQuota.Length 成员设置为 IrpSp-Parameters.QueryQuota.Length>。

如果 IrpSp-Flags 设置了 SL_RESTART_SCAN 位，则 QueryQuota.RestartScan> 成员设置为非零。

如果 IrpSp-Flags 设置了 SL_RETURN_SINGLE_ENTRY 位，则 QueryQuota.ReturnSingleEntry> 成员设置为非零。

如果 IrpSp-Flags 设置了 SL_INDEX_SPECIFIED 位，则 QueryQuota.IndexSpecified> 成员设置为非零。

成功后，网络微型重定向程序应将 RX_CONTEXT 结构的 Info.LengthRemaining 成员设置为要返回的配额信息的长度。如果成功调用 MRxQueryQuotaInfo，RDBSS 会将 IRP 的 IoStatus.Information 成员设置为 RX_CONTEXT 的 Info.LengthRemaining 成员。

如果成功调用 MRxQueryQuotaInfo ，则应将 RX_CONTEXT 结构的 InformationToReturn 成员设置为返回的配额信息的长度。如果调用不成功，应将 RX_CONTEXT 的 InformationToReturn 成员设置为零。