如何使用远程桌面连接代理客户端 API

远程桌面连接代理客户端 API 允许第三方协议供应商利用连接代理来加速处理使用其协议连接到场中的虚拟机或远程桌面服务器的连接。

说明

步骤1:获取 IConnectionBrokerClient 接口

初始化应用程序或协议提供程序后,请执行以下步骤。

  1. 调用 CBCreateClientInstance 函数以获取 IConnectionBrokerClient 接口。
  2. 只要需要,请保留 IConnectionBrokerClient 接口。
  3. 当不再需要 IConnectionBrokerClient 接口时,请调用 Release 方法。

步骤2:请求目标信息

如果你的协议提供程序收到传入连接请求,请执行以下步骤来调用 IConnectionBrokerClient:: GetTargetInfo 方法。 此方法从连接代理获取用于将连接重定向到的合适服务器。

  1. 创建一个可以使用 CreateEvent或类似函数发出信号的事件,以便用于 hStatusEvent 参数。
  2. pTargetInfopResult 参数分配内存。 在整个序列完成后,这些内存块必须保持不变。
  3. 填写包含有关传入连接的所有信息的 CB _ 连接 _ 信息 结构。
  4. 调用 GetTargetInfo 方法,并传递所有必需的参数。 这是一个异步方法,该方法将返回 IConnectionBrokerRequest 接口的实例。
  5. 等待 hStatusEvent 事件被设置。
  6. 每当设置 hStatusEvent 事件时,调用 IConnectionBrokerRequest:: CheckStatus 方法来确定请求的状态。
  7. CheckStatus 返回 CB _ STATUS _ 请求 _ 已完成 时, pTargetInfopResult 参数将包含其信息。 您可以跳出等待循环,因为将不再使用 hStatusEvent 参数。
  8. 使用 pTargetInfo 参数表示的 CB _ 目标 _ 信息结构中的信息来确定将传入连接重定向到的位置。
  9. 释放 IConnectionBrokerRequest 接口。
  10. 关闭 " hStatusEvent " 事件句柄,或者可以对后续连接请求重复使用它。