Cómo usar la API de cliente de Conexión a Escritorio remoto Broker

La API de cliente de Conexión a Escritorio remoto Broker permite a los proveedores de protocolos de terceros aprovechar el agente de conexión para agilizar el control de las conexiones que usan su Protocolo para conectarse a máquinas virtuales o servidores de Escritorio remoto en una granja.

Instrucciones

Paso 1: obtener la interfaz IConnectionBrokerClient

Una vez inicializado el proveedor de la aplicación o el protocolo, realice los pasos siguientes.

  1. Llame a la función CBCreateClientInstance para obtener la interfaz IConnectionBrokerClient .
  2. Mantenga la interfaz IConnectionBrokerClient siempre que la necesite.
  3. Cuando ya no se necesite la interfaz IConnectionBrokerClient , llame al método Release .

Paso 2: solicitar la información de destino

Cuando el proveedor de protocolo reciba una solicitud de conexión entrante, realice los pasos siguientes para llamar al método IConnectionBrokerClient:: GetTargetInfo . Este método obtiene, del agente de conexión, el servidor adecuado al que se redirigirá la conexión.

  1. Cree un evento que se pueda señalizar mediante el CreateEvent, o una función similar, para usar para el parámetro hStatusEvent .
  2. Asigne memoria para los parámetros pTargetInfo y pResult . Estos bloques de memoria deben permanecer vigentes hasta que se complete toda la secuencia.
  3. Rellene una estructura de _ _ información de conexión CB que contenga toda la información sobre la conexión entrante.
  4. Llame al método GetTargetInfo y pase todos los parámetros necesarios. Este es un método asincrónico que devolverá una instancia de la interfaz IConnectionBrokerRequest .
  5. Espere a que se establezca el evento hStatusEvent .
  6. Siempre que se establezca el evento hStatusEvent , llame al método IConnectionBrokerRequest:: CheckStatus para determinar el estado de la solicitud.
  7. Cuando CheckStatus devuelve la _ solicitud de estado CB _ _ completada, los parámetros pTargetInfo y pResult contendrán su información. Puede salir del bucle de espera porque ya no se usará el parámetro hStatusEvent .
  8. Utilice la información de la estructura de _ _ información del destino CB representada por el parámetro pTargetInfo para determinar a dónde debe redirigirse la conexión entrante.
  9. Libere la interfaz IConnectionBrokerRequest .
  10. Cierre el identificador de evento hStatusEvent o puede reutilizarlo para las solicitudes de conexión posteriores.