Delen via


Hoe de client-API voor de Connection Broker voor Extern bureaublad te gebruiken

Met de Client-API van Remote Desktop Connection Broker kunnen externe protocolleveranciers gebruikmaken van de Connection Broker om de verwerking van verbindingen die gebruikmaken van hun protocol om verbinding te maken met virtuele machines of extern bureaublad-servers in een farm te versnellen.

Aanwijzingen

Stap 1: de interface IConnectionBrokerClient verkrijgen

Wanneer uw toepassing of protocolprovider is geïnitialiseerd, voert u de volgende stappen uit.

  1. Roep de CBCreateClientInstance--functie aan om de interface IConnectionBrokerClient te verkrijgen.
  2. Houd de IConnectionBrokerClient interface zolang u deze nodig hebt.
  3. Wanneer de interface IConnectionBrokerClient niet meer nodig is, roept u de methode Release aan.

Stap 2: De doelgegevens aanvragen

Wanneer uw protocolprovider een binnenkomende verbindingsaanvraag ontvangt, voert u de volgende stappen uit om de methode IConnectionBrokerClient::GetTargetInfo aan te roepen. Deze methode verkrijgt van de Connection Broker de juiste server om de verbinding naar door te sturen.

  1. Maak een gebeurtenis die kan worden gesignaleerd met behulp van de CreateEvent-, of een vergelijkbare functie, om te gebruiken voor de parameter hStatusEvent.
  2. Wijs geheugen toe voor de pTargetInfo- en pResult- parameters. Deze geheugenblokken moeten aanwezig blijven totdat deze hele reeks is voltooid.
  3. Vul een CB_CONNECTION_INFO structuur in die alle informatie over de binnenkomende verbinding bevat.
  4. Roep de GetTargetInfo methode aan, waarbij alle vereiste parameters worden doorgegeven. Dit is een asynchrone methode die een exemplaar van de IConnectionBrokerRequest interface retourneert.
  5. Wacht tot de gebeurtenis hStatusEvent is ingesteld.
  6. Wanneer de gebeurtenis hStatusEvent is ingesteld, roept u de methode IConnectionBrokerRequest::CheckStatus aan om de status van de aanvraag te bepalen.
  7. Wanneer CheckStatusCB_STATUS_REQUEST_COMPLETEDretourneert, bevatten de parameters pTargetInfo en pResult parameters hun gegevens. U kunt de wachtlus verbreken omdat de parameter hStatusEvent niet meer wordt gebruikt.
  8. Gebruik de informatie in de CB_TARGET_INFO structuur die wordt vertegenwoordigd door de parameter pTargetInfo om te bepalen waar de binnenkomende verbinding naar moet worden omgeleid.
  9. Maak de interface IConnectionBrokerRequest vrij.
  10. Sluit de hStatusEvent gebeurtenisafhandeling of u kunt deze opnieuw gebruiken voor volgende verbindingsaanvragen.