Partager via

Inscription du plug-in DVC

  • Article

Le plug-in de canal virtuel dynamique (DVC) est inscrit pour une utilisation 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 de contrôle ActiveX (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\Software\Client Microsoft\Terminal Server\\AddIns par défaut\nom de plug-in unique

    Note

    Vous devez créer le nom de plug-in unique sous-clé s’il n’existe pas. Le nom de plug-in unique nom de sous-clé 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 d’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 de CLSID.

" plug-inDLLName"»

La DLL implémente la fonctionVirtualChannelGetInstanceet l’exporte par nom. Le client RDC utilise la fonction VirtualChannelGetInstance pour obtenir 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 standard à l’aide de CoCreateInstance avec le CLSID.

Note

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 RDC (Remote Desktop Connection) 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 Initialiser 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 connectés et méthodes de déconnectées.
  4. Le dernier appel que le plug-in doit gérer est terminé. Il s’agit d’un signal indiquant que le client RDC (Remote Desktop Connection) est sur le point de décharger le plug-in.