Метод 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 немедленно в случае успешного выполнения.

Требования

См. также

ITsSbPlugin

IWTSSBPlugin