MRxQueryEaInfo 例程

项目
06/15/2023

RDBSS 调用 MRxQueryEaInfo 例程来请求网络微型重定向程序查询文件系统对象上的扩展属性信息。

语法

PMRX_CALLDOWN MRxQueryEaInfo;

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

参数

RxContext [in， out]
指向RX_CONTEXT 结构的指针。此参数包含请求操作的 IRP。

返回值

MRxQueryEaInfo 在成功时返回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_EA_CORRUPT_ERROR	从远程服务器接收了无效的扩展属性信息。
STATUS_INSUFFICIENT_RESOURCES	资源不足，无法完成查询。
STATUS_INVALID_PARAMETER	指定的参数无效。
STATUS_NONEXISTENT_EA_ENTRY	文件对象上没有扩展属性，并且用户提供了扩展属性索引。
STATUS_NOT_SUPPORTED	不支持扩展属性。
STATUS_ONLY_IF_CONNECTED	SRV_OPEN结构未连接。
STATUS_REQUEST_ABORTED	网络请求已中止。

注解

RDBSS 发出对 MRxQueryEaInfo 的调用，以响应接收 IRP_MJ_QUERY_EA 请求。

在调用 MRxQueryEaInfo 之前，RDBSS 修改 RxContext 参数指向的 RX_CONTEXT 结构中的以下成员：

Info.Buffer 成员设置为来自 I/O 请求数据包的用户缓冲区。如果需要，RDBSS 已锁定此缓冲区。

Info.LengthRemaining 成员设置为 IrpSp-Parameters.QueryEa.Length>。

QueryEa.UserEaList 成员设置为 IrpSp-Parameters.QueryEa.EaList>。

QueryEa.UserEaListLength 成员设置为 IrpSp-Parameters.QueryEa.EaListLength>。

QueryEa.UserEaIndex 成员设置为 IrpSp-Parameters.QueryEa.EaIndex>。

如果 IrpSp-Flags> 具有SL_RESTART_SCAN位，则 QueryEa.RestartScan 成员设置为非零。

如果 IrpSp-Flags> 具有SL_RETURN_SINGLE_ENTRY位，则 QueryEa.ReturnSingleEntry 成员设置为非零。

如果 IrpSp-Flags> 具有SL_INDEX_SPECIFIED位，则 QueryEa.IndexSpecified 成员设置为非零。

成功后，MRxQueryEaInfo 应将 RX_CONTEXT 结构的 Info.LengthRemaininging 成员设置为返回的扩展属性信息的长度，并更新 Fobx-OffsetOfNextEaToReturn> 成员。如果成功调用 MRxQueryEaInfo，RDBSS 会将 IRP 的 IoStatus.Information 成员设置为 IrpSp-Parameters.QueryEa.Length> 减去 RX_CONTEXT 的 Info.LengthRemaining 成员。