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