通过

RxCeBuildConnection 函数 (rxce.h)

  • 项目

RxCeBuildConnection 在本地 RDBSS 连接地址和给定的远程地址之间建立连接。

语法

NTSTATUS RxCeBuildConnection(
            IN PRXCE_ADDRESS                  pLocalAddress,
  [in]      IN PRXCE_CONNECTION_INFORMATION   pConnectionInformation,
  [in]      IN PRXCE_CONNECTION_EVENT_HANDLER pHandler,
  [in]      IN PVOID                          pEventContext,
  [in, out] IN OUT PRXCE_CONNECTION           pConnection,
  [in, out] IN OUT PRXCE_VC                   pVc
);

参数

pLocalAddress

指向本地 RDBSS 连接引擎地址的指针。

[in] pConnectionInformation

指向指定远程地址的连接信息的指针。

[in] pHandler

指向事件处理程序的指针，用于处理接收指示。

[in] pEventContext

指向要传递回事件处理程序并用于指示的上下文参数的指针。

[in, out] pConnection

输入时，此参数包含指向未初始化的 RDBSS 连接的指针。 当此调用成功时输出时，连接将正确初始化。

[in, out] pVc

输入时，此参数包含指向未初始化 RDBSS 虚拟线路的指针。 当此调用成功时输出时，虚拟线路与连接相关联，并且虚拟线路已正确初始化。

返回值

RxCeBuildConnection 在成功时返回STATUS_SUCCESS或失败时返回以下错误代码之一：

返回代码 说明
STATUS_INSUFFICIENT_RESOURCES
 此例程所需的非分页池内存分配失败。
STATUS_INVALID_PARAMETER
 传递给此例程的参数之一无效。

注解

应在系统工作线程的上下文中调用 RxCeBuildConnection。

RxCeBuildConnection 成功后，pConnection 参数指向的 RXCE_CONNECTION 结构中的数据成员和 pVc 参数指向的 RXCE_VC 结构中的数据成员将正确初始化，并且虚拟线路将与连接相关联。

RXCE_CONNECTION_INFORMATION 是 TDI_CONNECTION_INFORMATION 结构的 typedef。

要求

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

另请参阅

RxCeTearDownConnection

TDI_CONNECTION_INFORMATION