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

Confira também

ITsSbPlugin

IWTSSBPlugin