Método IWTSSBPlugin::WTSSBX_GetMostSuitableServer (tssbx.h)
[Não há suporte para a interface IWTSSBPlugin após o Windows Server 2008 R2. Começando com Windows Server 2012 use a interface ITsSbPlugin.]
Retorna a ID do servidor para o qual o Agente de Sessão dos Serviços de Terminal (Agente de Sessão TS) deve direcionar a conexão de entrada. A lógica de redirecionamento do plug-in determina o servidor preferencial.
Sintaxe
HRESULT WTSSBX_GetMostSuitableServer(
[in] WCHAR *UserName,
[in] WCHAR *DomainName,
[in] WCHAR *ApplicationType,
[in] WCHAR *FarmName,
[in, out] long *pMachineId
);
Parâmetros
[in] UserName
Um ponteiro para uma cadeia de caracteres Unicode que contém o nome de usuário da conexão de entrada.
[in] DomainName
Um ponteiro para uma cadeia de caracteres Unicode que contém o nome de domínio associado à conexão de entrada.
[in] ApplicationType
Um ponteiro para uma cadeia de caracteres Unicode que contém o nome do programa que os Serviços de Área de Trabalho Remota executam após a criação da sessão.
[in] FarmName
Um ponteiro para uma cadeia de caracteres Unicode que contém o nome do farm no Agente de Sessão do TS ao qual o usuário está se conectando.
[in, out] pMachineId
Um ponteiro para a ID do servidor para o qual o Agente de Sessão do TS redirecionará a conexão de entrada. Inicialmente, esse valor é definido como a ID do servidor fornecida pela lógica de balanceamento de carga do Agente de Sessão TS.
Retornar valor
Retorna S_OK se tiver êxito.
Comentários
Use WTSSBX_GetMostSuitableServer para substituir a lógica de balanceamento de carga padrão do Agente de Sessão TS. O Agente de Sessão do TS chama esse método depois de executar sua própria lógica de balanceamento de carga. O parâmetro pMachineId é inicialmente definido como a ID do servidor fornecida pela lógica de balanceamento de carga do Agente de Sessão TS. Quando você implementa esse método, sua lógica de redirecionamento pode retornar essa pMachineId ou outra conforme apropriado.
Sempre que um servidor ingressa em um farm no Agente de Sessão do TS, o Agente de Sessão do TS chama o método WTSSBX_MachineChangeNotification para notificar o plug-in e fornecer um MachineId para identificar o novo servidor. Quando o Agente de Sessão do TS chama WTSSBX_GetMostSuitableServer, o plug-in deve retornar uma das IDs fornecidas pelo Agente de Sessão do TS ao plug-in. O plug-in não deve retornar a ID de um servidor que não está no farm.
Sua implementação de WTSSBX_GetMostSuitableServer deve retornar S_OK imediatamente se tiver êxito.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | tssbx.h |