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 [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