Метод IWTSSBPlugin::WTSSBX_GetMostSuitableServer (tssbx.h)
[Интерфейс IWTSSBPlugin не поддерживается после Windows Server 2008 R2. Начиная с Windows Server 2012 используйте интерфейс ITsSbPlugin.]
Возвращает идентификатор сервера, на который брокер сеансов служб терминалов (посредник сеансов TS) должен направлять входящее соединение. Логика перенаправления подключаемого модуля определяет предпочтительный сервер.
Синтаксис
HRESULT WTSSBX_GetMostSuitableServer(
[in] WCHAR *UserName,
[in] WCHAR *DomainName,
[in] WCHAR *ApplicationType,
[in] WCHAR *FarmName,
[in, out] long *pMachineId
);
Параметры
[in] UserName
Указатель на строку Юникода, содержащую имя пользователя входящего подключения.
[in] DomainName
Указатель на строку Юникода, содержащую доменное имя, связанное с входящим подключением.
[in] ApplicationType
Указатель на строку Юникода, содержащую имя программы, запускаемой службами удаленных рабочих столов после создания сеанса.
[in] FarmName
Указатель на строку Юникода, содержащую имя фермы в брокере сеансов TS, к которому подключается пользователь.
[in, out] pMachineId
Указатель на идентификатор сервера, на который брокер сеансов TS перенаправит входящее подключение. Изначально для этого значения задается идентификатор сервера, предоставленный логикой балансировки нагрузки брокера сеансов TS.
Возвращаемое значение
В случае успешного выполнения возвращает S_OK.
Комментарии
Используйте WTSSBX_GetMostSuitableServer , чтобы переопределить логику балансировки нагрузки по умолчанию брокера сеансов TS. Брокер сеансов TS вызывает этот метод после запуска собственной логики балансировки нагрузки. Параметру pMachineId изначально присваивается идентификатор сервера, предоставленный логикой балансировки нагрузки брокера сеансов TS. При реализации этого метода логика перенаправления может возвращать этот pMachineId или другой метод соответствующим образом.
Всякий раз, когда сервер присоединяется к ферме в брокере сеансов TS, брокер сеансов TS вызывает метод WTSSBX_MachineChangeNotification для уведомления подключаемого модуля и предоставления MachineId для идентификации нового сервера. Когда брокер сеансов TS вызывает WTSSBX_GetMostSuitableServer, подключаемый модуль должен вернуть один из идентификаторов, предоставленных брокером сеансов TS для подключаемого модуля. Подключаемый модуль не должен возвращать идентификатор сервера, который не находится в ферме.
Реализация WTSSBX_GetMostSuitableServer должна немедленно возвращать S_OK в случае успешного выполнения.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | tssbx.h |