Método IWTSSBPlugin::WTSSBX_GetMostSuitableServer (tssbx.h)

[La interfaz IWTSSBPlugin no se admite después de Windows Server 2008 R2. A partir de Windows Server 2012 use la interfaz ITsSbPlugin.]

Devuelve el identificador del servidor al que el Agente de sesión de Terminal Services (Agente de sesión de TS) debe dirigir la conexión entrante. La lógica de redireccionamiento del complemento determina el servidor preferido.

Sintaxis

HRESULT WTSSBX_GetMostSuitableServer(
  [in]      WCHAR *UserName,
  [in]      WCHAR *DomainName,
  [in]      WCHAR *ApplicationType,
  [in]      WCHAR *FarmName,
  [in, out] long  *pMachineId
);

Parámetros

[in] UserName

Puntero a una cadena Unicode que contiene el nombre de usuario de la conexión entrante.

[in] DomainName

Puntero a una cadena Unicode que contiene el nombre de dominio asociado a la conexión entrante.

[in] ApplicationType

Puntero a una cadena Unicode que contiene el nombre del programa que se ejecuta servicios de Escritorio remoto después de crear la sesión.

[in] FarmName

Puntero a una cadena Unicode que contiene el nombre de la granja de servidores en el Agente de sesión de TS al que se conecta el usuario.

[in, out] pMachineId

Puntero al identificador del servidor al que el Agente de sesión de TS redirigirá la conexión entrante. Este valor se establece inicialmente en el identificador del servidor proporcionado por la lógica de equilibrio de carga del Agente de sesión de TS.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente.

Comentarios

Use WTSSBX_GetMostSuitableServer para invalidar la lógica de equilibrio de carga predeterminada del Agente de sesión de TS. El Agente de sesión de TS llama a este método después de ejecutar su propia lógica de equilibrio de carga. El parámetro pMachineId se establece inicialmente en el identificador del servidor proporcionado por la lógica de equilibrio de carga del Agente de sesión de TS. Al implementar este método, la lógica de redireccionamiento puede devolver este pMachineId u otro según corresponda.

Cada vez que un servidor se une a una granja de servidores en el Agente de sesión de TS, el Agente de sesión de TS llama al método WTSSBX_MachineChangeNotification para notificar al complemento y proporcionar un MachineId para identificar el nuevo servidor. Cuando el Agente de sesión de TS llama a WTSSBX_GetMostSuitableServer, el complemento debe devolver uno de los identificadores que TS Session Broker proporcionó al complemento. El complemento no debe devolver el identificador de un servidor que no está en la granja de servidores.

La implementación de WTSSBX_GetMostSuitableServer debe devolver S_OK inmediatamente si se realiza correctamente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	tssbx.h

Consulte también

ITsSbPlugin

IWTSSBPlugin