Partager via

Inscription du plug-in DVC

  • Article

Le plug-in de canal virtuel dynamique (DVC) est inscrit pour être utilisé par le client de connexion Bureau à distance (RDC) à l’aide de l’une des méthodes suivantes :

  • Appel de la méthode IMsTscAdvancedSettings::p ut_PluginDlls du contrôle ActiveX RDP (Remote Desktop Protocol). Plusieurs entrées doivent être séparées par des virgules.

  • Écriture de l’entrée de plug-in à l’emplacement suivant dans le Registre sur l’ordinateur sur lequel le processus client de connexion Bureau à distance (RDC) est démarré :

    HKEY_CURRENT_USER\Logiciel\Microsoft\Client\ Terminal Server Par défaut\Addins\nom unique du plug-in

    Notes

    Vous devez créer la sous-clé de nom de plug-in unique si elle n’existe pas. Le nom unique de la sous-clé de nom de plug-in est une chaîne arbitraire qui peut identifier le plug-in. La chaîne peut être n’importe quelle combinaison de caractères.

     

    Sous nom de plug-in unique, vous devez ajouter une entrée qui identifie le plug-in.

    Nom de l’entrée = Nom

    Type de données = REG_SZ ou REG_EXPAND_SZ

Dans les deux cas, la valeur d’entrée doit être conforme à l’un des formats suivants :

« Plug-inDLLName:{CLSID} »

Le plug-in n’est pas nécessairement inscrit dans le Registre Windows en tant qu’objet COM (Component Object Model), mais la DLL est implémentée en tant qu’objet COM in-process. Le client RDC charge la DLL spécifiée par Plug-inDLLName et récupère l’objet COM directement à l’aide du CLSID.

« Plug-inDLLName »

La DLL implémente la fonction VirtualChannelGetInstance et l’exporte par nom. Le client RDC utilise la fonction VirtualChannelGetInstance pour obtenir des pointeurs d’interface IWTSPlugin pour tous les plug-ins implémentés par la DLL.

« {CLSID} »

Le client RDC instancie le plug-in en tant qu’objet COM normal à l’aide de CoCreateInstance avec le CLSID.

Notes

Plug-inDLLName représente le chemin d’accès complet et le nom de fichier du fichier .dll. Si le type de données est REG_EXPAND_SZ, le chemin d’accès peut contenir des variables d’environnement non expirées qui sont développées au moment de l’exécution.

 

Lorsque le client de connexion Bureau à distance (RDC) termine son initialisation, il effectue les opérations suivantes pour chaque plug-in inscrit :

  1. Obtenez une instance de l’interface IWTSPlugin pour chaque plug-in à l’aide de l’une des méthodes décrites ci-dessus.
  2. Appelez la méthode Initialize de chaque interface IWTSPlugin .
  3. Si le client se connecte plusieurs fois au même serveur ou à un autre serveur, il peut y avoir plusieurs appels aux méthodes Connectée et Déconnectée .
  4. Le dernier appel que le plug-in doit gérer est Terminé. Il s’agit d’un signal indiquant que le client de connexion Bureau à distance (RDC) est sur le point de décharger le plug-in.