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 de conexión a Escritorio remoto (RDC):

    HKEY_CURRENT_USER\Software\Microsoft\ Cliente \de Terminal ServerPredeterminado\Addins\nombre de complemento único

    Nota

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

     

    En el nombre único del complemento, 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 modelo de objetos componentes (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ón VirtualChannelGetInstance 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 clSID.

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 en tiempo de ejecución.

 

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

  1. Obtenga una instancia de la interfaz IWTSPlugin 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 a los métodos Connected y Disconnected .
  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.