如何使用遠端桌面連線代理人用戶端 API

  • 發行項

遠端桌面連線代理人用戶端 API 可讓協力廠商通訊協定廠商利用連線代理人，加速處理使用其通訊協定連線到伺服器陣列中的虛擬機器或遠端桌面伺服器。

指示

步驟 1：取得 IConnectionBrokerClient 介面

當您的應用程式或通訊協定提供者初始化時，請執行下列步驟。

  1. 呼叫 CBCreateClientInstance 函式以取得 IConnectionBrokerClient 介面。
  2. 只要您需要，請保留 IConnectionBrokerClient 介面。
  3. 不再需要 IConnectionBrokerClient 介面時，請呼叫 Release 方法。

步驟 2：要求目標資訊

當您的通訊協定提供者收到連入連線要求時，請執行下列步驟來呼叫 IConnectionBrokerClient：：GetTargetInfo 方法。 這個方法會從連接代理人取得適當的伺服器，以重新導向連線。

  1. 建立可使用 CreateEvent或類似函式發出訊號的事件，以用於 hStatusEvent 參數。
  2. 配置 pTargetInfo 和 pResult 參數的記憶體。 這些記憶體區塊必須保持原狀，直到這個整個序列完成為止。
  3. 填寫包含連入連線相關資訊的 CB_CONNECTION_INFO 結構。
  4. 呼叫 GetTargetInfo 方法，並傳遞所有必要的參數。 這是會傳回 IConnectionBrokerRequest 介面實例的非同步方法。
  5. 等候 hStatusEvent 事件設定完成。
  6. 每當設定 hStatusEvent 事件時，呼叫 IConnectionBrokerRequest：：CheckStatus 方法來判斷要求的狀態。
  7. 當 CheckStatus 傳回 CB_STATUS_REQUEST_COMPLETED時， pTargetInfo 和 pResult 參數將包含其資訊。 您可以中斷等候迴圈，因為不再使用 hStatusEvent 參數。
  8. 使用pTargetInfo參數所代表之CB_TARGET_INFO結構中的資訊，判斷要重新導向連入連線的位置。
  9. 釋放 IConnectionBrokerRequest 介面。
  10. 關閉 hStatusEvent 事件控制碼，或者您可以針對後續的連線要求重複使用它。