如何使用遠端桌面連線代理人用戶端 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 _ 狀態 _ 要求 _ 已完成 時, pTargetInfopResult 參數會包含其資訊。 您可以中斷等候迴圈,因為 hStatusEvent 參數將不再使用。
  8. 使用 pTargetInfo 參數所代表的 CB _ 目標 _ 資訊結構中的資訊,來決定要將傳入連接重新導向至何處。
  9. 釋放 IConnectionBrokerRequest 介面。
  10. 關閉 hStatusEvent 事件控制碼,或將它重複用於後續的連接要求。