Condividi tramite

Come usare l'API client gestore connessione Desktop remoto

  • Articolo

L'API client gestore connessione Desktop remoto consente ai fornitori di protocolli di terze parti di sfruttare Gestore connessione per accelerare la gestione delle connessioni che usano il protocollo per connettersi alle macchine virtuali o ai server Desktop remoto in una farm.

Istruzioni

Passaggio 1: Ottenere l'interfaccia IConnectionBrokerClient

Quando l'applicazione o il provider di protocolli viene inizializzato, seguire questa procedura.

  1. Chiamare la funzione CBCreateClientInstance per ottenere l'interfaccia IConnectionBrokerClient .
  2. Mantenere l'interfaccia IConnectionBrokerClient purché sia necessaria.
  3. Quando l'interfaccia IConnectionBrokerClient non è più necessaria, chiamare il metodo Release .

Passaggio 2: Richiedere le informazioni di destinazione

Quando il provider di protocolli riceve una richiesta di connessione in ingresso, seguire questa procedura per chiamare il metodo IConnectionBrokerClient::GetTargetInfo . Questo metodo ottiene, dal Gestore connessione, il server appropriato a cui reindirizzare la connessione.

  1. Creare un evento che può essere segnalato usando la funzione CreateEvent o simile da usare per il parametro hStatusEvent .
  2. Allocare memoria per i parametri pTargetInfo e pResult . Questi blocchi di memoria devono rimanere attivi fino al completamento dell'intera sequenza.
  3. Compilare una struttura CB_CONNECTION_INFO che contiene tutte le informazioni sulla connessione in ingresso.
  4. Chiamare il metodo GetTargetInfo , passando tutti i parametri necessari. Si tratta di un metodo asincrono che restituirà un'istanza dell'interfaccia IConnectionBrokerRequest .
  5. Attendere che l'evento hStatusEvent diventi impostato.
  6. Ogni volta che viene impostato l'evento hStatusEvent , chiamare il metodo IConnectionBrokerRequest::CheckStatus per determinare lo stato della richiesta.
  7. Quando CheckStatus restituisce CB_STATUS_REQUEST_COMPLETED, i parametri pTargetInfo e pResult conterranno le relative informazioni. È possibile interrompere il ciclo di attesa perché il parametro hStatusEvent non verrà più usato.
  8. Usare le informazioni nella struttura CB_TARGET_INFO rappresentata dal parametro pTargetInfo per determinare dove reindirizzare la connessione in ingresso.
  9. Rilasciare l'interfaccia IConnectionBrokerRequest .
  10. Chiudere l'handle dell'evento hStatusEvent oppure riutilizzarlo per le richieste di connessione successive.