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 |
| 标头 |
|
| 库 |
|
| DLL |
|