Share via

Utilisation du contrôle ActiveX Bureau à distance avec des canaux virtuels

  • Article

Si vous avez activé une application de canaux virtuels dans votre déploiement des services Bureau à distance, vous pouvez mettre cette application à la disposition des ordinateurs clients qui accèdent au serveur Hôte de session Bureau à distance (hôte de session Bureau à distance) au moyen du contrôle ActiveX Bureau à distance.

Pour rendre une application de canal virtuel disponible

  1. Déployez le module côté serveur de l’application et assurez-vous qu’il s’exécute sur le serveur hôte de session Bureau à distance. Dans la page de connexion de l’application web Services Bureau à distance en cours d’exécution sur votre serveur web, accédez à la propriété PluginDlls de l’interface IMsTscAdvancedSettings pour spécifier le nom de la DLL de votre canal virtuel. Si vous avez plusieurs plug-ins, spécifiez une liste de noms de DLL délimitées par des virgules. Par instance, si votre plug-in de canal virtuel est nommé « MyPlugin.dll », utilisez le code suivant :

    MsRdpClient.AdvancedSettings.PluginDlls = "myplugin.dll"

    Utilisez le code suivant si vous avez deux DLL de canal virtuel. Dans cet exemple, les noms de fichiers DLL sont « MyPlugin.dll » et « Vdriver.dll » :

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

    Pour des raisons de sécurité, la propriété PluginDlls accepte uniquement une liste nommée de DLL de canal virtuel. Le contrôle retourne une erreur si une forme de système de fichiers ou un chemin UNC est spécifiée. En outre, les noms des DLL doivent contenir uniquement des caractères alphanumériques.

  2. Vérifiez que le module côté client est installé dans le répertoire %windir%\system32.

L’API de canal virtuel n’autorise pas le chargement de plusieurs instances de la même DLL de canal virtuel au sein d’un même processus. Pour cette raison, si plusieurs instances du contrôle ActiveX Bureau à distance s’exécutent dans le même processus, seule la première instance du contrôle peut charger la DLL du canal virtuel. Si vous concevez une application de canal virtuel qui doit prendre en charge plusieurs instances au sein d’un même processus, vous devez utiliser l’API Canaux virtuels dynamiques pour implémenter votre application de canal virtuel.

Notes

Par défaut, le contrôle ActiveX bureau à distance charge les DLL clientes de canal virtuel à partir du répertoire %windir%\system32. Il est possible pour un administrateur de modifier ce répertoire DLL de plug-in client par défaut. Pour ce faire, modifiez la clé de Registre HKEY_LOCAL_MACHINE\Software\Microsoft\Terminal Server Client\vdllpath sur l’ordinateur client. Ce chemin d’accès au répertoire ne peut pas être spécifié au format UNC.