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.
- Appelez la fonction CBCreateClientInstance pour obtenir l’interface IConnectionBrokerClient .
- Conservez l’interface IConnectionBrokerClient tant que vous en avez besoin.
- 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.
- Créez un événement qui peut être signalé à l’aide de CreateEvent, ou d’une fonction similaire, à utiliser pour le paramètre hStatusEvent .
- 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.
- Renseignez une structure d' _ _ informations de connexion CB qui contient toutes les informations relatives à la connexion entrante.
- 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 .
- Attendez que l’événement hStatusEvent soit défini.
- Chaque fois que l’événement hStatusEvent est défini, appelez la méthode IConnectionBrokerRequest :: CheckStatus pour déterminer l’état de la demande.
- 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é.
- 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.
- Libérez l’interface IConnectionBrokerRequest .
- Fermez le handle d’événement hStatusEvent ou réutilisez-le pour les demandes de connexion suivantes.