RxCeQueryInformation 函数 (rxce.h)

RxCeQueryInformation 查询有关调用方分配的缓冲区中的连接的信息。

语法

NTSTATUS RxCeQueryInformation(
  [in]  IN PRXCE_VC                          pVc,
  [in]  IN RXCE_CONNECTION_INFORMATION_CLASS InformationClass,
  [out] OUT PVOID                            pInformation,
  [in]  IN ULONG                             Length
);

参数

[in] pVc

指向与此连接关联的虚拟线路的指针。

[in] InformationClass

此查询类型的所需信息类。 为 InformationClass 指定的值确定返回的信息类型。 此参数是在 rxcehdlr.h 中定义的枚举，可以是以下值之一：

RxCeTransportProviderInformation

查询传输中的提供程序信息。 成功时，RXCE_TRANSPORT_PROVIDER_INFO结构将复制到 pInformation 缓冲区。 请注意，RXCE_TRANSPORT_PROVIDER_INFO是TDI_PROVIDER_INFO的 typedef。

RxCeConnectionInformation

查询 获取有关连接的信息。 成功后，RXCE_CONNECTION_INFORMATION结构将复制到 pInformation 缓冲区。 请注意，RXCE_CONNECTION_INFORMATION是TDI_CONNECTION_INFORMATION的 typedef。

RxCeConnectionEndpointInformation

查询传输 有关连接终结点的信息。 成功时，RXCE_CONNECTION_INFO结构将复制到 pInformation 缓冲区。 请注意，RXCE_CONNECTION_INFO是TDI_CONNECTION_INFO的 typedef。

RxCeRemoteAddressInformation

查询传输 以获取有关远程地址的信息。 成功后，TDI_ADDRESS_INFO结构将复制到 pInformation 缓冲区。

[out] pInformation

调用方提供的用于返回信息的缓冲区。

[in] Length

缓冲区的长度。

返回值

RxCeQueryInformation 在成功时返回STATUS_SUCCESS，或者返回以下警告或错误代码之一：

返回代码	说明
STATUS_BUFFER_OVERFLOW	pInformation 指向的输出缓冲区的指定长度不足以接收 InformationClass 查询类型请求的信息。
STATUS_INSUFFICIENT_RESOURCES	此例程所需的非分页池内存分配失败。
STATUS_INVALID_PARAMETER	对于以下任一情况，都可以返回此值： 传递给此例程的 pVC 参数无效。 为此虚拟线路定义的连接、地址或传输无效。 此查询类型的 InformationClass 不是允许的值之一。

注解

RxCeQueryInformation 返回给定虚拟线路的信息。 在调用 RxCeQueryInformation 时，可以指定 InformationClass 的唯一值如下：

RxCeTransportProviderInformation

RxCeConnectionInformation

RxCeConnectionEndpointInformation

RxCeRemoteAddressInformation

对于 InformationClass 的某些值， RxCeQueryInformation 调用 TdiBuildQueryInformation 和 TDI 来检索请求的信息。

要求

要求	值
目标平台	桌面
标头	rxce.h (包括 Rxce.h、Rxcehdlr.h、Tdi.h)
IRQL	<= APC_LEVEL

另请参阅

RxCeQueryAdapterStatus

RxCeQueryTransportInformation