Подпрограмма MRxQuerySdInfo

ПодпрограммаMRxQuerySdInfo вызывается RDBSS для запроса запроса сетевого мини-перенаправителя сведений о дескрипторе безопасности объекта файловой системы.

Синтаксис

PMRX_CALLDOWN MRxQuerySdInfo;

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

Параметры

RxContext [in, out]
Указатель на структуру RX_CONTEXT. Этот параметр содержит IRP, запрашивающий операцию.

Возвращаемое значение

MRxQuerySdInfo возвращает 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_NETWORK_ACCESS_DENIED	Доступ к сети запрещен.
STATUS_NOT_IMPLEMENTED	Запрашиваемая функция, например сведения в удаленном файле подкачки, не реализована.
STATUS_NOT_SUPPORTED	Сведения о дескрипторов безопасности не поддерживаются в удаленной общей папке.
STATUS_OBJECT_PATH_NOT_FOUND	Путь к объекту не найден. Эта ошибка может быть возвращена, если была запрошена информация о объекте потока NTFS, а удаленная файловая система не поддерживает потоки.
STATUS_REPARSE	Для обработки символьной ссылки требуется повторная обработка.

Комментарии

RDBSS отправляет вызов MRxQuerySdInfo в ответ на получение запроса IRP_MJ_QUERY_SECURITY .

Перед вызовом MRxQuerySdInfo RDBSS изменяет следующие элементы в структуре RX_CONTEXT, на которую указывает параметр RxContext :

Для элемента QuerySecurity.SecurityInformation задано значение IrpSp-Parameters.QuerySecurity.SecurityInformation>.

Для элемента Info.Buffer задан буфер пользователя из пакета запроса ввода-вывода. При необходимости этот буфер уже заблокирован службой RDBSS.

Для элемента Info.LengthRemaining задано значение IrpSp-Parameters.QuerySecurity.Length>.

При успешном выполнении сетевой мини-перенаправитель должен задать для элемента InformationToReturn структуры RX_CONTEXT длину возвращаемых сведений о безопасности. Если вызов MRxQuerySdInfo был выполнен успешно, RDBSS устанавливает элемент IoStatus.Information IRP в элемент InformationToReturn RX_CONTEXT.

Требования

Целевая платформа	Персональный компьютер
Заголовок	Mrx.h (включая Mrx.h)

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

MRxIsValidDirectory

MRxQueryDirectory

MRxQueryEaInfo

MRxQueryFileInfo

MRxQueryQuotaInfo

MRxQueryVolumeInfo

MRxSetEaInfo

MRxSetFileInfo

MRxSetFileInfoAtCleanup

MRxSetQuotaInfo

MRxSetSdInfo

MRxSetVolumeInfo