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 |