Compartir a través de

Registro del complemento DVC

  • Artículo

El complemento de canal virtual dinámico (DVC) se registra para su uso por parte del cliente de conexión a Escritorio remoto (RDC) mediante uno de los métodos siguientes:

  • Invocar el método IMsTscAdvancedSettings::p ut_PluginDlls del control ActiveX del Protocolo de escritorio remoto (RDP). Varias entradas deben estar separadas por comas.

  • Escribir la entrada del complemento en la siguiente ubicación del Registro en el equipo donde se inicia el proceso de cliente conexión a Escritorio remoto (RDC):

    HKEY_CURRENT_USER\Software\cliente de Microsoft\Terminal Server\\AddIns predeterminado\nombre de complemento único

    Nota

    Debe crear el nombre de complemento único subclave si no existe. El nombre de complemento único nombre de subclave es una cadena arbitraria que puede identificar el complemento. La cadena puede ser cualquier combinación de caracteres.

     

    En nombre de complemento único, debe agregar una entrada que identifique el complemento.

    Nombre de entrada = Nombre

    Tipo de datos = REG_SZ o REG_EXPAND_SZ

En ambos casos, el valor de entrada debe cumplir uno de los siguientes formatos:

"Plug-inDLLName:{CLSID}"

El complemento no se registra necesariamente en el Registro de Windows como un objeto Component Object Model (COM), pero el archivo DLL se implementa como un objeto COM en proceso. El cliente RDC cargará el archivo DLL especificado por plug-inDLLName y recuperará el objeto COM directamente mediante CLSID.

"Plug-inDLLName"

El archivo DLL implementa la funciónVirtualChannelGetInstance y la exporta por nombre. El cliente RDC usará la función virtualChannelGetInstance para obtener punteros de interfaz IWTSPlugin para todos los complementos implementados por el archivo DLL.

"{CLSID}"

El cliente RDC creará una instancia del complemento como un objeto COM normal mediante CoCreateInstance con el CLSID de.

Nota

plug-inDLLName representa la ruta de acceso completa y el nombre de archivo del archivo .dll. Si el tipo de datos es REG_EXPAND_SZ, la ruta de acceso puede contener variables de entorno no expandidas que se expanden en tiempo de ejecución.

 

Cuando el cliente de Conexión a Escritorio remoto (RDC) finaliza su inicialización, realizará lo siguiente para cada complemento registrado:

  1. Obtenga una instancia de la interfazIWTSPlugin para cada complemento mediante uno de los métodos descritos anteriormente.
  2. Llame al método Initialize de cada interfaz IWTSPlugin.
  3. Si el cliente se conecta varias veces al mismo servidor o a otro servidor, puede haber varias llamadas al Connected y Métodos de Desconectados.
  4. La última llamada que debe controlar el complemento es Terminated. Es una señal de que el cliente de conexión a Escritorio remoto (RDC) está a punto de descargar el complemento.