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

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

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

Синтаксис

HRESULT WTSSBX_GetUserExternalSession(
  [in]  WCHAR                       *UserName,
  [in]  WCHAR                       *DomainName,
  [in]  WCHAR                       *ApplicationType,
  [in]  WTSSBX_IP_ADDRESS           *RedirectorInternalIP,
  [out] DWORD                       *pSessionId,
  [out] WTSSBX_MACHINE_CONNECT_INFO *pMachineConnectInfo
);

Параметры

[in] UserName

Указатель на строку Юникода, содержащую имя пользователя входящего подключения.

[in] DomainName

Указатель на строку Юникода, содержащую доменное имя входящего подключения.

[in] ApplicationType

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

[in] RedirectorInternalIP

Указатель на внутренний IP-адрес сервера узла сеансов удаленных рабочих стола, который впервые принял подключение.

[out] pSessionId

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

[out] pMachineConnectInfo

Указатель на структуру WTSSBX_MACHINE_CONNECT_INFO , содержащую сведения о компьютере, к которому подключаемый модуль направляет входящее подключение.

Возвращаемое значение

В случае успешного выполнения возвращает S_OK.

Комментарии

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

Реализация WTSSBX_GetUserExternalSession должна возвращать E_NOTIMPL , если она не поддерживает перенаправление на компьютеры, которые не присоединены к фермам в брокере сеансов TS.

Требования

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

ITsSbPlugin

IWTSSBPlugin