Метод IWTSSBPlugin::WTSSBX_GetMostSuitableServer (tssbx.h)

Статья
08/26/2023

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

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

ITsSbPlugin

IWTSSBPlugin

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