Utilisation de l’API cliente Connexion Bureau à distance Broker

L’API cliente Connexion Bureau à distance Broker permet aux fournisseurs de protocoles tiers de tirer parti du répartiteur de connexions pour accélérer la gestion des connexions qui utilisent leur protocole pour se connecter à des ordinateurs virtuels ou à des serveurs Bureau à distance dans une batterie de serveurs.

Instructions

Étape 1 : obtenir l’interface IConnectionBrokerClient

Lorsque votre application ou fournisseur de protocole est initialisé, procédez comme suit.

  1. Appelez la fonction CBCreateClientInstance pour obtenir l’interface IConnectionBrokerClient .
  2. Conservez l’interface IConnectionBrokerClient tant que vous en avez besoin.
  3. Lorsque l’interface IConnectionBrokerClient n’est plus nécessaire, appelez la méthode Release .

Étape 2 : demander les informations sur la cible

Lorsque votre fournisseur de protocole reçoit une demande de connexion entrante, procédez comme suit pour appeler la méthode IConnectionBrokerClient :: GetTargetInfo . Cette méthode obtient, à partir du répartiteur de connexions, le serveur approprié vers lequel rediriger la connexion.

  1. Créez un événement qui peut être signalé à l’aide de CreateEvent, ou d’une fonction similaire, à utiliser pour le paramètre hStatusEvent .
  2. Allouez de la mémoire pour les paramètres pTargetInfo et pResult . Ces blocs de mémoire doivent rester en place jusqu’à ce que l’intégralité de la séquence soit terminée.
  3. Renseignez une structure d' _ _ informations de connexion CB qui contient toutes les informations relatives à la connexion entrante.
  4. Appelez la méthode GetTargetInfo , en passant tous les paramètres requis. Il s’agit d’une méthode asynchrone qui retourne une instance de l’interface IConnectionBrokerRequest .
  5. Attendez que l’événement hStatusEvent soit défini.
  6. Chaque fois que l’événement hStatusEvent est défini, appelez la méthode IConnectionBrokerRequest :: CheckStatus pour déterminer l’état de la demande.
  7. Lorsque CheckStatus retourne la _ demande d’État CB _ _ terminée, les paramètres pTargetInfo et pResult contiennent leurs informations. Vous pouvez quitter la boucle d’attente, car le paramètre hStatusEvent ne sera plus utilisé.
  8. Utilisez les informations de la structure d’informations de la _ cible _ CB représentée par le paramètre pTargetInfo pour déterminer où rediriger la connexion entrante.
  9. Libérez l’interface IConnectionBrokerRequest .
  10. Fermez le handle d’événement hStatusEvent ou réutilisez-le pour les demandes de connexion suivantes.