Registo de plug-in DVC

O plug-in de canal virtual dinâmico (DVC) é registrado para uso pelo cliente de Conexão de Área de Trabalho Remota (RDC) usando um dos seguintes métodos:

• Invocando o IMsTscAdvancedSettings::p ut_PluginDlls método do controle ActiveX RDP (Remote Desktop Protocol). Várias entradas devem ser separadas por vírgula.

• Gravando a entrada do plug-in no seguinte local no Registro no computador onde o processo do cliente RDC (Conexão de Área de Trabalho Remota) é iniciado:

  Software HKEY_CURRENT_USER\\Microsoft\Terminal Server Client\Default\AddIns\nome de plug-in exclusivo

  Observação

  Você deve criar o nome plug-in exclusivo subchave se ele não existir. O nome exclusivo do plug-in nome da subchave é uma cadeia de caracteres arbitrária que pode identificar o plug-in. A cadeia de caracteres pode ser qualquer combinação de caracteres.

   

  Em nome de plug-in exclusivo, você deve adicionar uma entrada que identifique o plug-in.

  Nome da entrada = Nome

  Tipo de dados = REG_SZ ou REG_EXPAND_SZ

Em ambos os casos, o valor de entrada deve estar em conformidade com um dos seguintes formatos:

"Plug-inDLLName:{CLSID}"

O plug-in não é necessariamente registrado no registro do Windows como um objeto COM (Component Object Model), mas a DLL é implementada como um objeto COM em processo. O cliente RDC carregará a DLL especificada por Plug-inDLLName e recuperará o objeto COM diretamente usando CLSID.

"Plug-inDLLName"

A DLL implementa a funçãoVirtualChannelGetInstance e a exporta pelo nome. O cliente RDC usará a função VirtualChannelGetInstance para obter ponteiros de interface IWTSPlugin para todos os plug-ins implementados pela DLL.

"{CLSID}"

O cliente RDC instanciará o plug-in como um objeto COM regular usando CoCreateInstance com o CLSID.

Observação

Plug-inDLLName representa o caminho completo e o nome do arquivo .dll. Se o tipo de dados for REG_EXPAND_SZ, o caminho pode conter variáveis de ambiente não expandidas que são expandidas em tempo de execução.

 

Quando o cliente RDC (Conexão de Área de Trabalho Remota) concluir sua inicialização, ele executará o seguinte para cada plug-in registrado:

1. Obtenha uma instância do interface de IWTSPlugin para cada plug-in usando um dos métodos descritos acima.
2. Chame o Initialize método de cada IWTSPlugin interface.
3. Se o cliente se conectar várias vezes ao mesmo servidor ou a um servidor diferente, pode haver várias chamadas para os métodos Connected e Disconnected.
4. A última chamada que o plug-in deve lidar é Terminated. É um sinal de que o cliente de Conexão de Área de Trabalho Remota (RDC) está prestes a descarregar o plug-in.