Freigeben über


ITsSbLoadBalancing::GetMostSuitableTarget-Methode (sbtsv.h)

Hierbei handelt es sich um eine Rückrufmethode, die Sie in Ihrer App implementieren, um das am besten geeignete Ziel zu bestimmen, an das eine eingehende Clientverbindung ausgerichtet werden soll. Der Remotedesktopverbindungsbroker (RD-Verbindungsbroker) ruft Ihre Implementierung auf, wenn der Broker eine eingehende Clientverbindung umleiten muss.

Syntax

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

Parameter

[in] pConnection

Ein Zeiger auf ein ITsSbClientConnection-Objekt . Spezifische Informationen für eine Clientverbindung, z. B. Benutzername und Farmname, können von diesem Objekt abgerufen werden.

[in] pLBSink

Ein Zeiger auf ein ITsSbLoadBalancingNotifySink-Objekt . Wenn das Plug-In erfolgreich ermittelt, wohin die Verbindung umgeleitet werden soll, sollte das Ergebnis des Lastenausgleichs mithilfe dieses Senkenobjekts zurückgegeben werden. Weitere Informationen finden Sie unter ITsSbLoadBalanceResult.

Rückgabewert

Wenn die Methode erfolgreich ist, geben Sie S_OK zurück. Andernfalls geben Sie einen Fehler an, indem Sie alleFehler-HRESULT zurückgeben. Wenn Ihr Plug-In jedoch angeben soll, dass ein Ziel nicht ermittelt werden konnte, können Sie E_SB_LOAD_BAL_FAILED zurückgeben.

Hinweise

Der Standardalgorithmus für den Lastenausgleich im RD-Verbindungsbroker leitet eine eingehende Verbindung mit den wenigsten Remotesitzungen an den Server um. Ihr Plug-In kann diese Methode verwenden, um den standardlastenausgleichsalgorithmus zu überschreiben. Sie können beispielsweise einen Algorithmus definieren, der Serververbindungen zuweist, indem Sie die Ressourcennutzung auf den Zielservern vergleichen. Sie können die Verbindung auch basierend auf den Informationen im Clientverbindungsobjekt umleiten, z. B. die InitialProgram-Eigenschaft .

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2012
Zielplattform Windows
Kopfzeile sbtsv.h

Weitere Informationen

ITsSbClientConnection

ITsSbLoadBalanceResult

ITsSbLoadBalancing

ITsSbLoadBalancingNotifySink