ITsSbLoadBalancing：：GetMostSuitableTarget 方法 (sbtsv.h)

發行項
03/05/2024

這是您在應用程式中實作的回呼方法，用來判斷要導向連入用戶端連線的最適合目標。當訊息代理程式需要重新導向連入用戶端連線時，遠端桌面連線代理人 (RD 連線代理人) 呼叫您的實作。

語法

HRESULT GetMostSuitableTarget(
  [in] ITsSbClientConnection        *pConnection,
  [in] ITsSbLoadBalancingNotifySink *pLBSink
);

參數

[in] pConnection

ITsSbClientConnection 物件的指標。用戶端連接的特定資訊，例如使用者名稱和伺服器數位名稱，可以從這個物件取得。

[in] pLBSink

ITsSbLoadBalancingNotifySink 物件的指標。如果外掛程式成功判斷重新導向連線的位置，它應該使用此接收對象傳回負載平衡結果。如需詳細資訊，請參閱 ITsSbLoadBalanceResult。

傳回值

如果方法成功，則傳回 S_OK。否則，傳回任何失敗 HRESULT 來表示失敗。但是，如果您想要讓外掛程式指出它無法判斷目標，則可以傳回 E_SB_LOAD_BAL_FAILED。

備註

RD 連線代理人中的預設負載平衡演算法會將連入連線重新導向至具有最少遠端會話的伺服器。您的外掛程式可以使用這個方法來覆寫預設負載平衡演算法。例如，您可以藉由比較目標伺服器上的資源使用量，來定義指派伺服器的連線的演算法。您也可以根據客戶端連接物件中的資訊重新導向連接，例如 InitialProgram 屬性。