ITsSbLoadBalancing::GetMostSuitableTarget メソッド (sbtsv.h)

これは、受信クライアント接続を転送する最も適切なターゲットを決定するために、アプリに実装するコールバック メソッドです。 リモート デスクトップ接続ブローカー (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 プロパティなど、クライアント接続オブジェクトの情報に基づいて接続をリダイレクトすることもできます。

要件

こちらもご覧ください

ITsSbClientConnection

ITsSbLoadBalanceResult

ITsSbLoadBalancing

ITsSbLoadBalancingNotifySink