Jak używać interfejsu API klienta brokera połączeń pulpitu zdalnego

Interfejs API klienta brokera połączeń usług pulpitu zdalnego umożliwia dostawcom protokołów innych firm korzystanie z brokera połączeń w celu przyspieszenia obsługi połączeń, które używają ich protokołu do łączenia się z maszynami wirtualnymi lub serwerami usług pulpitu zdalnego w farmie.

Instrukcje

Krok 1. Uzyskiwanie interfejsu IConnectionBrokerClient

Po zainicjowaniu aplikacji lub dostawcy protokołu wykonaj następujące kroki.

1. Wywołaj funkcję CBCreateClientInstance, aby uzyskać interfejs IConnectionBrokerClient.
2. Zachowaj interfejs IConnectionBrokerClient, o ile jest potrzebny.
3. Gdy interfejs IConnectionBrokerClient nie jest już potrzebny, wywołaj metodę Release.

Krok 2. Żądanie informacji docelowych

Gdy dostawca protokołu odbiera przychodzące żądanie połączenia, wykonaj następujące kroki, aby wywołać metodę IConnectionBrokerClient::GetTargetInfo. Ta metoda uzyskuje z brokera połączeń odpowiedni serwer w celu przekierowania połączenia do.

1. Utwórz zdarzenie, które można zasygnalizować przy użyciu CreateEventlub podobnej funkcji, aby użyć parametru hStatusEvent.
2. Przydziel pamięć dla parametrów pTargetInfo i pResult. Te bloki pamięci muszą pozostać w miejscu do momentu ukończenia całej sekwencji.
3. Wypełnij CB_CONNECTION_INFO strukturę zawierającą wszystkie informacje o połączeniu przychodzącym.
4. Wywołaj metodę GetTargetInfo, przekazując wszystkie wymagane parametry. Jest to metoda asynchroniczna, która zwróci instancję interfejsu IConnectionBrokerRequest.
5. Poczekaj, aż zdarzenie hStatusEvent zostanie ustawione.
6. Za każdym razem, gdy ustawiono zdarzenie hStatusEvent, wywołaj metodę IConnectionBrokerRequest::CheckStatus, aby określić stan żądania.
7. Gdy CheckStatus zwraca wartość CB_STATUS_REQUEST_COMPLETED, pTargetInfo i parametry pResult będą zawierać informacje. Pętlę oczekiwania można przerwać, ponieważ parametr hStatusEvent nie będzie już używany.
8. Użyj informacji w strukturze CB_TARGET_INFO reprezentowanej przez parametr pTargetInfo, aby określić miejsce przekierowania połączenia przychodzącego do.
9. Zwolnij interfejs IConnectionBrokerRequest.
10. Zamknij uchwyt zdarzenia hStatusEvent lub możesz go ponownie wykorzystać do kolejnych żądań połączenia.