Dela via

Så här använder du klient-API:et för anslutningsförmedlaren för fjärrskrivbord

  • Artikel

Klient-API:et för anslutningsförmedlare för fjärrskrivbord gör det möjligt för tredjepartsprotokollleverantörer att utnyttja denna anslutningsförmedlare för att påskynda hanteringen av anslutningar som använder deras protokoll för att ansluta till virtuella datorer eller fjärrskrivbordsservrar i ett kluster.

Instruktioner

Steg 1: Hämta gränssnittet IConnectionBrokerClient

Utför följande steg när program- eller protokollprovidern initieras.

  1. Anropa funktionen CBCreateClientInstance för att hämta gränssnittet IConnectionBrokerClient.
  2. Behåll IConnectionBrokerClient--gränssnittet så länge du behöver det.
  3. När IConnectionBrokerClient-gränssnittet inte längre behövs anropar du metoden Release.

Steg 2: Begär målinformationen

När din protokollprovider tar emot en inkommande anslutningsbegäran utför du följande steg för att anropa metoden IConnectionBrokerClient::GetTargetInfo. Den här metoden hämtar rätt server från anslutningsmäklaren för att omdirigera anslutningen.

  1. Skapa en händelse som kan signaleras med hjälp av funktionen CreateEventeller liknande som ska användas för parametern hStatusEvent.
  2. Allokera minne för parametrarna pTargetInfo och pResult. Dessa minnesblock måste finnas kvar tills hela sekvensen har slutförts.
  3. Fyll i en CB_CONNECTION_INFO struktur som innehåller all information om den inkommande anslutningen.
  4. Anropa metoden GetTargetInfo och skicka alla nödvändiga parametrar. Det här är en asynkron metod som returnerar en instans av IConnectionBrokerRequest--gränssnittet.
  5. Vänta tills händelsen hStatusEvent blir aktiv.
  6. När händelsen hStatusEvent anges anropar du metoden IConnectionBrokerRequest::CheckStatus för att fastställa status för begäran.
  7. När CheckStatus returnerar CB_STATUS_REQUEST_COMPLETEDinnehåller parametrarna pTargetInfo och pResult deras information. Du kan bryta dig ur vänteloopen eftersom parametern hStatusEvent inte längre används.
  8. Använd informationen i den CB_TARGET_INFO struktur som representeras av parametern pTargetInfo för att avgöra var den inkommande anslutningen ska omdirigeras till.
  9. Släpp gränssnittet IConnectionBrokerRequest.
  10. Stäng händelsehandtaget hStatusEvent eller återanvänd den för efterföljande anslutningsbegäranden.