IConnectionBrokerClient：：GetTargetInfo 方法

  • 项目

请求有关应重定向连接的目标计算机的信息。 重定向程序使用此方法获取传入连接请求的重定向信息。

语法

HRESULT GetTargetInfo(
  [in]  CB_CONNECTION_INFO       *pConnectionInfo,
  [in]  DWORD                    Reserved,
  [in]  HANDLE                   hStatusEvent,
  [out] CB_TARGET_INFO           *pTargetInfo,
  [out] DWORD                    *pResult,
  [out] IConnectionBrokerRequest **ppCbReq
);

parameters

pConnectionInfo [in]

包含传入连接请求信息 CB_CONNECTION_INFO 结构的地址。

保留 [in]

此参数保留供将来使用，必须为零。

hStatusEvent [in]

每当请求进度有更新时，都会设置的事件的句柄。 你负责创建和关闭此事件。

pTargetInfo [out]

CB_TARGET_INFO结构的地址，该结构接收应重定向传入连接的目标计算机的相关信息。 由于这是一种异步方法，因此在请求完成之前，此内存必须保持可用状态。 有关详细信息，请参阅“备注”。

pResult [out]

接收结果代码的 DWORD 变量的地址。 由于这是一种异步方法，因此在请求完成之前，此内存必须保持可用状态。 有关详细信息，请参阅“备注”。

此结果代码将是以下值之一。

0

成功。

0x0000400

找不到目标计算机。

0x0000401

目标计算机不可用。

0x0000402

加载目标计算机时出错。

0x0000403

使目标计算机联机时出错。

0x0000404

重定向到目标计算机时出错。

0x0000405

唤醒虚拟机时出错。

0x0000406

启动虚拟机时出错。

0x0000407

查找虚拟机的 IP 地址时出错。

0x0000408

会话代理找不到池中的任何可用计算机。

0x0000409

会话代理取消了连接。

0x0000410

会话代理无法验证连接设置。

ppCbReq [out]

用于获取异步操作状态更新的 IConnectionBrokerRequest 接口指针的地址。 此接口与 hStatusEvent 参数结合使用，等待并获取此异步操作的结果。

返回值

如果创建异步请求，则返回 E_PENDING 。 否则，它将返回 HRESULT 错误代码。

注解

此方法是异步方法。 pTargetInfo 和 pResult 参数必须保持有效，直到 IConnectionBrokerRequest：：CheckStatus 方法获取CB_STATUS_REQUEST_COMPLETED。

有关如何使用此方法的详细信息，请参阅 如何使用远程桌面连接代理客户端 API。

要求

要求 值
最低受支持的客户端
 Windows 8
最低受支持的服务器
 Windows Server 2012
标头
Cbclient.h
库
Cbclient.lib
DLL
Cbclient.dll

另请参阅

IConnectionBrokerClient