Интерфейс IWTSSBPlugin (tssbx.h)

[Интерфейс IWTSSBPlugin не поддерживается после Windows Server 2008 R2. Начиная с Windows Server 2012 используйте интерфейс ITsSbPlugin.]

Используется для расширения возможностей брокера сеансов служб терминалов (брокера сеансов TS). Реализуйте этот интерфейс, если требуется предоставить подключаемый модуль, который переопределяет логику перенаправления брокера сеансов TS.

Наследование

Интерфейс IWTSSBPlugin наследуется от интерфейса IUnknown . IWTSSBPlugin также имеет следующие типы элементов:

Методы

Интерфейс IWTSSBPlugin содержит следующие методы.

IWTSSBPlugin::Initialize Инициализирует подключаемый модуль и возвращает значение, указывающее возможности перенаправления подключаемого модуля.
IWTSSBPlugin::Terminated Уведомляет подключаемый модуль о том, что он будет уничтожен брокером сеансов служб терминалов (брокер сеансов TS).
IWTSSBPlugin::WTSSBX_GetMostSuitableServer Возвращает идентификатор сервера, на который брокер сеансов служб терминалов (посредник сеансов TS) должен направлять входящее соединение.
IWTSSBPlugin::WTSSBX_GetUserExternalSession Перенаправляет входящее подключение к вычислительному ресурсу, такому как виртуальная машина, сервер колонки или даже корпоративный рабочий стол пользователя, предоставляя WTSSBX_MACHINE_CONNECT_INFO структуру, содержащую сведения о ресурсе.
IWTSSBPlugin::WTSSBX_MachineChangeNotification Уведомляет подключаемый модуль о том, что в серверной среде произошло изменение.
IWTSSBPlugin::WTSSBX_SessionChangeNotification Уведомляет подключаемый модуль о том, что в сеансе произошло изменение, например вход, выход из системы, отключение или повторное подключение.

Комментарии

Брокер сеансов TS вызывает метод WTSSBX_GetUserExternalSession , чтобы подключаемый модуль может направлять входящее подключение к компьютеру, который не принадлежит ферме в брокере сеансов TS.

Кроме того, брокер сеансов TS вызывает метод WTSSBX_GetMostSuitableServer , чтобы подключаемый модуль может направлять входящее подключение к компьютеру, который принадлежит ферме в брокере сеансов TS.

Эти методы ссылаются на отдельный сервер в ферме с помощью уникального MachineId , назначенного серверу брокером сеансов TS. Когда сервер присоединяется к ферме в брокере сеансов TS, брокер сеансов TS вызывает метод WTSSBX_MachineChangeNotification для уведомления подключаемого модуля об изменении и передачи MachineId нового сервера в подключаемый модуль.

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	tssbx.h

См. также раздел

ITsSbPlugin

Расширяемость брокера подключений к удаленному рабочему столу