Подпрограмма MRxQueryQuotaInfo
Подпрограмма MRxQueryQuotaInfo вызывается RDBSS для запроса сведений о квоте сетевого мини-перенаправления в объекте файловой системы.
Синтаксис
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 | Буфер для получения сведений о квоте был слишком мал. Это возвращаемое значение следует считать успешным, и в элементе Info.Buffer структуры RX_CONTEXT, на которую указывает параметр RxContext , должно быть возвращено как можно больше допустимых данных. |
| STATUS_BUFFER_TOO_SMALL | Буфер слишком мал для получения запрошенных данных. Если это значение возвращается, для элемента InformationToReturn структуры RX_CONTEXT, на которую указывает параметр RxContext , должен быть задан минимальный размер ожидаемого буфера для успешного вызова. |
| STATUS_CONNECTION_DISCONNECTED | Подключение было отключено. Это код ошибки. |
| STATUS_INSUFFICIENT_RESOURCES | Недостаточно ресурсов для выполнения запроса. Это код ошибки. |
| STATUS_INVALID_PARAMETER | Указан недопустимый параметр. Это код ошибки. |
| STATUS_NOT_SUPPORTED | Квоты не поддерживаются. |
Комментарии
RDBSS отправляет вызов MRxQueryQuotaInfo в ответ на получение запроса IRP_MJ_QUERY_QUOTA .
Перед вызовом MRxQueryQuotaInfo RDBSS изменяет следующие элементы в структуре RX_CONTEXT, на которую указывает параметр RxContext :
Для элемента Info.Buffer задан буфер пользователя из пакета запроса ввода-вывода. При необходимости этот буфер уже заблокирован 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>.
Для элемента QueryQuota.RestartScan задано ненулевое значение, если для IrpSp-Flags> задан бит SL_RESTART_SCAN.
Элемент QueryQuota.ReturnSingleEntry имеет ненулевое значение, если для IrpSp-Flags> задан бит SL_RETURN_SINGLE_ENTRY.
Элемент QueryQuota.IndexSpecified имеет ненулевое значение, если для IrpSp-Flags> задан бит SL_INDEX_SPECIFIED.
При успешном выполнении мини-перенаправитель сети должен задать для элемента Info.LengthRemaining структуры RX_CONTEXT длину возвращаемых сведений о квоте. Если вызов MRxQueryQuotaInfo был успешным, RDBSS задает элемент IoStatus.Information IRP в значение Info.LengthRemaining RX_CONTEXT.
Если вызов MRxQueryQuotaInfo выполнен успешно, для элемента InformationToReturn структуры RX_CONTEXT следует задать длину возвращаемых сведений о квоте. Если вызов не выполнен, для элемента InformationToReturn RX_CONTEXT должно быть задано значение 0.
Требования
Целевая платформа |
Персональный компьютер |
Заголовок |
Mrx.h (включая Mrx.h) |