MRxQueryQuotaInfo 例程
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 成员设置为零。
要求
目标平台 |
桌面 |
标头 |
Mrx.h (包括 Mrx.h) |