Share via


Uso del control ActiveX de Escritorio remoto con canales virtuales

Si ha habilitado una aplicación de canales virtuales en la implementación de Servicios de Escritorio remoto, puede hacer que esta aplicación esté disponible para los equipos cliente que acceden al servidor host de sesión de Escritorio remoto (host de sesión de Escritorio remoto) mediante el control ActiveX de Escritorio remoto.

Para que una aplicación de canal virtual esté disponible

  1. Implemente el módulo del lado servidor de la aplicación y asegúrese de que se ejecuta en el servidor host de sesión de Escritorio remoto. En la página de conexión de la aplicación web Servicios de Escritorio remoto que se ejecuta en el servidor web, acceda a la propiedad PluginDlls de la interfaz IMsTscAdvancedSettings para especificar el nombre del archivo DLL del canal virtual. Si tiene más de un complemento, especifique una lista delimitada por comas de nombres DLL. Por ejemplo, si el complemento de canal virtual se denomina "MyPlugin.dll", use el código siguiente:

    MsRdpClient.AdvancedSettings.PluginDlls = "myplugin.dll"
    

    Use el código siguiente si tiene dos archivos DLL de canal virtual. En este ejemplo, los nombres de archivo DLL son "MyPlugin.dll" y "Vdriver.dll":

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

    Por motivos de seguridad, la propiedad PluginDlls solo acepta una lista con nombre de archivos DLL de canal virtual. El control devuelve un error si se especifica cualquier forma de sistema de archivos o ruta de acceso UNC. Además, los nombres de los archivos DLL solo deben contener caracteres alfanuméricos.

  2. Asegúrese de que el módulo del lado cliente está instalado en el directorio %windir%\system32.

La API de canal virtual no permite cargar varias instancias del mismo archivo DLL de canal virtual dentro de un único proceso. Por este motivo, si hay varias instancias del control ActiveX de Escritorio remoto que se ejecuta dentro del mismo proceso, solo la primera instancia del control podrá cargar el archivo DLL del canal virtual. Si va a diseñar una aplicación de canal virtual que debe admitir varias instancias dentro de un único proceso, debe usar la API de canales virtuales dinámicos para implementar la aplicación de canal virtual.

Nota

De forma predeterminada, el control ActiveX de Escritorio remoto carga archivos DLL de cliente de canal virtual desde el directorio %windir%\system32. Es posible que un administrador cambie este directorio DLL del complemento de cliente predeterminado. Para ello, edite la clave del Registrovdllpath de cliente deMicrosoft\Terminal Server\ de software de HKEY_LOCAL_MACHINE\\ en el equipo cliente. Esta ruta de acceso de directorio no se puede especificar en el formato UNC.