Compartilhar via


Método ITsSbLoadBalancing::GetMostSuitableTarget (sbtsv.h)

Esse é um método de retorno de chamada que você implementa em seu aplicativo, a fim de determinar o destino mais adequado para o qual direcionar uma conexão de cliente de entrada. O Agente de Conexão de Área de Trabalho Remota (Agente de Conexão de Área de Trabalho Remota) chama sua implementação quando o agente precisa redirecionar uma conexão de cliente de entrada.

Sintaxe

HRESULT GetMostSuitableTarget(
  [in] ITsSbClientConnection        *pConnection,
  [in] ITsSbLoadBalancingNotifySink *pLBSink
);

Parâmetros

[in] pConnection

Um ponteiro para um objeto ITsSbClientConnection . Informações específicas de uma conexão de cliente, como nome de usuário e nome de farm, podem ser obtidas desse objeto.

[in] pLBSink

Um ponteiro para um objeto ITsSbLoadBalancingNotifySink . Se o plug-in determinar com êxito para onde redirecionar a conexão, ele deverá retornar o resultado do balanceamento de carga usando esse objeto de coletor. Para obter mais informações, consulte ITsSbLoadBalanceResult.

Retornar valor

Se o método for bem-sucedido, retorne S_OK. Caso contrário, indique a falha retornando qualquerHRESULT de falha. Mas se você quiser que o plug-in in indique que ele falhou ao determinar um destino, poderá retornar E_SB_LOAD_BAL_FAILED.

Comentários

O algoritmo de balanceamento de carga padrão no Agente de Conexão de Área de Trabalho Remota redireciona uma conexão de entrada para o servidor com o menor número de sessões remotas. O plug-in pode usar esse método para substituir o algoritmo de balanceamento de carga padrão. Por exemplo, você pode definir um algoritmo que atribui conexões a servidores comparando o uso de recursos nos servidores de destino. Você também pode redirecionar a conexão com base nas informações no objeto de conexão do cliente, como a propriedade InitialProgram .

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Windows
Cabeçalho sbtsv.h

Confira também

ITsSbClientConnection

ITsSbLoadBalanceResult

ITsSbLoadBalancing

ITsSbLoadBalancingNotifySink