Подпрограмма 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)

См. также раздел

MRxIsValidDirectory

MRxQueryDirectory

MRxQueryEaInfo

MRxQueryFileInfo

MRxQuerySdInfo

MRxQueryVolumeInfo

MRxSetEaInfo

MRxSetFileInfo

MRxSetFileInfoAtCleanup

MRxSetQuotaInfo

MRxSetSdInfo

MRxSetVolumeInfo