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
);

参数

pConnectionInfo [中]

包含传入连接请求相关信息的 CB _ 连接 _ 信息 结构的地址。

保留 [中]

此参数保留以供将来使用,并且必须为零。

hStatusEvent [中]

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

pTargetInfo [弄]

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

pResult [弄]

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

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

0

成功。

0x0000400

找不到目标计算机。

0x0000401

目标计算机不可用。

0x0000402

加载目标计算机时出错。

0x0000403

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

0x0000404

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

0x0000405

唤醒虚拟机时出错。

0x0000406

启动虚拟机时出错。

0x0000407

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

0x0000408

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

0x0000409

会话 broker 已取消连接。

0x0000410

会话 broker 无法验证连接设置。

ppCbReq [弄]

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

返回值

如果创建异步请求,则返回 E _ PENDING 。 否则,它将返回 HRESULT 错误代码。

备注

此方法是异步方法。 PTargetInfopResult 参数必须保持有效,直到 IConnectionBrokerRequest:: CheckStatus方法获取 CB _ STATUS _ 请求 _ 已完成

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

要求

要求
最低受支持的客户端
Windows 8
最低受支持的服务器
Windows Server 2012
标头
Cbclient

Cbclient
DLL
Cbclient.dll

请参阅

IConnectionBrokerClient