Compartilhar via


Interface IWTSPlugin (tsvirtualchannels.h)

Permite que o plug-in do cliente RDC (Conexão de Área de Trabalho Remota) seja carregado pelo cliente RDC (Conexão de Área de Trabalho Remota). A interface é implementada pelo plug-in e é obtida e gerenciada pelo cliente RDC.

O cliente RDC obtém uma instância dessa interface instanciando o objeto COM ou chamando a função VirtualChannelGetInstance implementada pelo plug-in. Para obter mais informações sobre como as instâncias são obtidas, consulte Registro de plug-in DVC. Em todos os casos, essa instância é mantida durante o tempo de vida do cliente RDC (Conexão de Área de Trabalho Remota).

Como um objeto COM, o plug-in deve ser implementado em um modelo de threading livre. Como os métodos IWTSPlugin são implementados pelo plug-in, o plug-in deve estar ciente de que a chamada pode chegar em threads diferentes. As chamadas sempre chegarão em série, portanto, é impossível ter duas chamadas executadas em paralelo.

A implementação não deve bloquear essas chamadas porque isso pode bloquear outras conexões de entrada ou dados em conexões existentes.

Herança

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

Métodos

A interface IWTSPlugin tem esses métodos.

 
IWTSPlugin::Connected

Notifica o plug-in de que o cliente RDC (Conexão de Área de Trabalho Remota) se conectou com êxito ao servidor host da sessão da Área de Trabalho Remota (Host da Sessão da Área de Trabalho Remota).
IWTSPlugin::D isconnected

Notifica o plug-in de que o cliente RDC (Conexão de Área de Trabalho Remota) se desconectou do servidor host da sessão da Área de Trabalho Remota (Host da Sessão da Área de Trabalho Remota).
IWTSPlugin::Initialize

Usado para a primeira chamada feita do cliente para o plug-in.
IWTSPlugin::Terminated

Notifica o plug-in de que o cliente RDC (Conexão de Área de Trabalho Remota) foi encerrado.

Comentários

A interface IWTSPlugin é implementada pelo %System32%\webauthn.dll para habilitar a funcionalidade de redirecionamento do WebAuthn da Área de Trabalho Remota. Obtenha uma instância dessa interface chamando VirtualChannelGetInstance, que também é fornecida por webauthn.dll.

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho tsvirtualchannels.h