Поделиться через


Интерфейс 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

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