Méthode ITsSbLoadBalancing ::GetMostSuitableTarget (sbtsv.h)

Article
03/01/2024

Il s’agit d’une méthode de rappel que vous implémentez dans votre application, afin de déterminer la cible la plus appropriée à laquelle diriger une connexion cliente entrante. Le Répartiteur de connexions Bureau à distance (Broker pour les connexions Bureau à distance) appelle votre implémentation lorsque le répartiteur doit rediriger une connexion cliente entrante.

Syntaxe

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

Paramètres

[in] pConnection

Pointeur vers un objet ITsSbClientConnection . Des informations spécifiques à une connexion cliente, telles que le nom d’utilisateur et le nom de la batterie, peuvent être obtenues à partir de cet objet.

[in] pLBSink

Pointeur vers un objet ITsSbLoadBalancingNotifySink . Si le plug-in détermine correctement où rediriger la connexion, il doit retourner le résultat de l’équilibrage de charge à l’aide de cet objet récepteur. Pour plus d’informations, consultez ITsSbLoadBalanceResult.

Valeur retournée

Si la méthode réussit, retournez S_OK. Sinon, indiquez l’échec en retournant toute défaillance HRESULT. Toutefois, si vous souhaitez que votre plug-in indique qu’il n’a pas pu déterminer une cible, vous pouvez retourner E_SB_LOAD_BAL_FAILED.

Remarques

L’algorithme d’équilibrage de charge par défaut dans Le répartiteur de connexions Bureau à distance redirige une connexion entrante vers le serveur avec le moins de sessions distantes. Votre plug-in peut utiliser cette méthode pour remplacer l’algorithme d’équilibrage de charge par défaut. Par exemple, vous pouvez définir un algorithme qui attribue des connexions aux serveurs en comparant l’utilisation des ressources sur les serveurs cibles. Vous pouvez également rediriger la connexion en fonction des informations contenues dans l’objet de connexion client, comme la propriété InitialProgram .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Windows
En-tête	sbtsv.h

Voir aussi

ITsSbClientConnection

ITsSbLoadBalanceResult

ITsSbLoadBalancing

ITsSbLoadBalancingNotifySink

Share via