Interface IWTSSBPlugin (tssbx.h)

[A interface IWTSSBPlugin não tem suporte após o Windows Server 2008 R2. Começando com Windows Server 2012 use a interface ITsSbPlugin.]

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

Herança

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

Métodos

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 de Serviços de Terminal (Agente de Sessão 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.

Comentários

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.

Requisitos

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

Confira também

ITsSbPlugin

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