Compartilhar via


Interface IWTSSBPlugin (tssbx.h)

[Não há suporte para a interface IWTSSBPlugin após o Windows Server 2008 R2. A partir do Windows Server 2012, use a interface ITsSbPlugin .]

Usado para estender os recursos do Agente de Sessão dos Serviços de Terminal (Agente de Sessão TS). Implemente essa interface quando quiser fornecer um plug-in que substitua a lógica de redirecionamento do Agente de Sessão TS.

Herança

A interface IWTSSBPlugin herda da interface IUnknown . O IWTSSBPlugin também tem esses tipos de membros:

Methods

A interface IWTSSBPlugin tem esses métodos.

 
IWTSSBPlugin::Initialize

Inicializa o plug-in e retorna um valor que indica os recursos de redirecionamento do plug-in.
IWTSSBPlugin::Terminated

Notifica o plug-in de que ele está prestes a ser destruído pelo Agente de Sessão dos Serviços de Terminal (Agente de Sessão do TS).
IWTSSBPlugin::WTSSBX_GetMostSuitableServer

Retorna a ID do servidor para o qual o Agente de Sessão dos Serviços de Terminal (Agente de Sessão do TS) deve direcionar a conexão de entrada.
IWTSSBPlugin::WTSSBX_GetUserExternalSession

Redireciona uma conexão de entrada para um recurso de computação, como uma máquina virtual, um servidor de folhas ou até mesmo a própria área de trabalho corporativa do usuário, fornecendo uma estrutura WTSSBX_MACHINE_CONNECT_INFO que contém informações sobre o recurso.
IWTSSBPlugin::WTSSBX_MachineChangeNotification

Notifica o plug-in de que ocorreu uma alteração no ambiente do servidor.
IWTSSBPlugin::WTSSBX_SessionChangeNotification

Notifica o plug-in de que uma alteração, como logon, logoff, desconexão ou reconexão, ocorreu na sessão.

Observações

O Agente de Sessão do TS chama o método WTSSBX_GetUserExternalSession para que o plug-in possa direcionar uma conexão de entrada para um computador que não pertence a um farm no Agente de Sessão do TS.

Como alternativa, o Agente de Sessão do TS chama o método WTSSBX_GetMostSuitableServer para que o plug-in possa direcionar uma conexão de entrada para um computador que pertence a um farm no Agente de Sessão do TS.

Esses métodos fazem referência a um servidor individual no farm usando a MachineId exclusiva atribuída ao servidor pelo Agente de Sessão do TS. Quando 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 da alteração e passar a MachineId do novo servidor para o plug-in.

Requirements

Requirement Value
Cliente mínimo suportado Nenhum compatível
Servidor mínimo compatível Windows Server 2008
da Plataforma de Destino Windows
Header tssbx.h

Consulte também

ITsSbPlugin

Extensibilidade do Agente de Conexão de Área de Trabalho Remota