IWTSSBPlugin::WTSSBX_GetMostSuitableServer 메서드(tssbx.h)

[ IWTSSBPlugin 인터페이스는 Windows Server 2008 R2 이후에 지원되지 않습니다. Windows Server 2012 ITsSbPlugin 인터페이스를 사용하세요.]

터미널 서비스 세션 브로커(TS 세션 브로커)가 들어오는 연결을 전달해야 하는 서버의 ID를 반환합니다. 플러그 인의 리디렉션 논리에 따라 기본 서버가 결정됩니다.

구문

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 Session Broker에서 팜의 이름을 포함하는 유니코드 문자열에 대한 포인터입니다.

[in, out] pMachineId

TS Session Broker가 들어오는 연결을 리디렉션할 서버의 ID에 대한 포인터입니다. 이 값은 처음에 TS 세션 브로커의 부하 분산 논리에서 제공하는 서버의 ID로 설정됩니다.

반환 값

성공하면 S_OK 반환합니다.

설명

WTSSBX_GetMostSuitableServer 사용하여 TS Session Broker의 기본 부하 분산 논리를 재정의합니다. TS Session Broker는 자체 부하 분산 논리를 실행한 후 이 메서드를 호출합니다. pMachineId 매개 변수는 처음에 TS 세션 브로커의 부하 분산 논리에서 제공하는 서버의 ID로 설정됩니다. 이 메서드를 구현할 때 리디렉션 논리는 이 pMachineId 또는 다른 pMachineId 를 적절하게 반환할 수 있습니다.

서버가 TS 세션 브로커에서 팜에 조인할 때마다 TS Session Broker는 WTSSBX_MachineChangeNotification 메서드를 호출하여 플러그 인에 알리고 새 서버를 식별하는 MachineId를 제공합니다. TS Session Broker가 WTSSBX_GetMostSuitableServer 호출하는 경우 플러그 인은 TS Session Broker가 플러그 인에 제공한 ID 중 하나를 반환해야 합니다. 플러그 인은 팜에 없는 서버의 ID를 반환해서는 안 됩니다.

WTSSBX_GetMostSuitableServer 구현은 성공하면 즉시 S_OK 반환해야 합니다.

요구 사항

추가 정보

ITsSbPlugin

IWTSSBPlugin