Compartilhar via

Usando o controle de ActiveX da Área de Trabalho Remota com canais virtuais

  • Artigo

Se você tiver habilitado um aplicativo de canais virtuais em sua implantação dos Serviços de Área de Trabalho Remota, poderá disponibilizar esse aplicativo para computadores cliente que acessam o servidor do Host de Sessão da Área de Trabalho Remota (Host de Sessão de Área de Trabalho Remota) por meio do controle de ActiveX da Área de Trabalho Remota.

Para disponibilizar um aplicativo de canal virtual

  1. Implante o módulo do lado do servidor do aplicativo e verifique se ele está em execução no servidor host de sessão rd. Na página de conexão do aplicativo Web dos Serviços de Área de Trabalho Remota em execução no servidor Web, acesse a propriedade PluginDlls da interface IMsTscAdvancedSettings para especificar o nome da DLL do canal virtual. Se você tiver mais de um plug-in, especifique uma lista delimitada por vírgulas de nomes de DLL. Por exemplo, se o plug-in do canal virtual for chamado "MyPlugin.dll", use o seguinte código:

    MsRdpClient.AdvancedSettings.PluginDlls = "myplugin.dll"

    Use o código a seguir se você tiver duas DLLs de canal virtual. Neste exemplo, os nomes de arquivo DLL são "MyPlugin.dll" e "Vdriver.dll":

    MsRdpClient.AdvancedSettings.PluginDlls = "myplugin.dll,Vdriver.dll"

    Por motivos de segurança, a propriedade PluginDlls aceita apenas uma lista nomeada de DLLs de canal virtual. O controle retornará um erro se qualquer forma de sistema de arquivos ou caminho UNC for especificada. Além disso, os nomes das DLLs devem conter apenas caracteres alfanuméricos.

  2. Verifique se o módulo do lado do cliente está instalado no diretório %windir%\system32.

A API de canal virtual não permite que várias instâncias da mesma DLL de canal virtual sejam carregadas em um único processo. Por isso, se houver várias instâncias do controle de ActiveX da Área de Trabalho Remota em execução no mesmo processo, somente a primeira instância do controle poderá carregar a DLL do canal virtual. Se você estiver criando um aplicativo de canal virtual que deve dar suporte a várias instâncias em um único processo, deverá usar a API de Canais Virtuais Dinâmicos para implementar seu aplicativo de canal virtual.

Observação

Por padrão, o controle de ActiveX de Área de Trabalho Remota carrega DLLs de cliente de canal virtual do diretório %windir%\system32. É possível que um administrador altere esse diretório DLL de plug-in de cliente padrão. Para fazer isso, edite a chave de registro HKEY_LOCAL_MACHINE\ SoftwareMicrosoftTerminal\\ServerClientvdllpath\ no computador cliente. Esse caminho de diretório não pode ser especificado no formato UNC.