Méthode ITsSbLoadBalancing ::GetMostSuitableTarget (sbtsv.h)
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 |