Verwenden des Remotedesktop-ActiveX-Steuerelements mit virtuellen Kanälen

Wenn Sie eine Anwendung für virtuelle Kanäle in Ihrer Remotedesktopdienste-Bereitstellung aktiviert haben, können Sie diese Anwendung für Clientcomputer verfügbar machen, die über das ActiveX-Remotedesktop-Steuerelement auf den Remotedesktopsitzungshostserver (RD-Sitzungshost) zugreifen.

So stellen Sie eine Virtuelle Kanalanwendung zur Verfügung

1. Stellen Sie das serverseitige Modul der Anwendung bereit, und stellen Sie sicher, dass es auf dem RD-Sitzungshostserver ausgeführt wird. Greifen Sie auf der Verbindungsseite der Remotedesktopdienste-Webanwendung, die auf Ihrem Webserver ausgeführt wird, auf die PluginDlls-Eigenschaft der IMsTscAdvancedSettings-Schnittstelle zu, um den Namen Ihrer DLL für virtuellen Kanal anzugeben. Wenn Sie über mehrere Plug-Ins verfügen, geben Sie eine durch Trennzeichen getrennte Liste von DLL-Namen an. Verwenden Sie für instance den folgenden Code, wenn Ihr virtuelles Kanal-Plug-In "MyPlugin.dll" heißt:

   MsRdpClient.AdvancedSettings.PluginDlls = "myplugin.dll"
   

   Verwenden Sie den folgenden Code, wenn Sie über zwei DLLs für virtuelle Kanäle verfügen. In diesem Beispiel sind die DLL-Dateinamen "MyPlugin.dll" und "Vdriver.dll":

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

   Aus Sicherheitsgründen akzeptiert die PluginDlls-Eigenschaft nur eine benannte Liste virtueller Kanal-DLLs. Das Steuerelement gibt einen Fehler zurück, wenn eine Form von Dateisystem oder UNC-Pfad angegeben wird. Darüber hinaus dürfen die Namen der DLLs nur alphanumerische Zeichen enthalten.

2. Stellen Sie sicher, dass das clientseitige Modul im Verzeichnis %windir%\system32 installiert ist.

Die API für virtuelle Kanäle lässt nicht zu, dass mehrere Instanzen derselben DLL für virtuelle Kanäle innerhalb eines einzelnen Prozesses geladen werden. Wenn daher mehrere Instanzen des ActiveX-Remotedesktopsteuerelements innerhalb desselben Prozesses ausgeführt werden, kann nur die erste instance des Steuerelements die DLL des virtuellen Kanals laden. Wenn Sie eine Anwendung für virtuelle Kanäle entwerfen, die mehrere Instanzen innerhalb eines einzelnen Prozesses unterstützen muss, müssen Sie die API für dynamische virtuelle Kanäle verwenden, um Ihre virtuelle Kanalanwendung zu implementieren.

Hinweis

Standardmäßig lädt das ActiveX-Remotedesktop-Steuerelement virtuelle Kanal-Client-DLLs aus dem Verzeichnis %windir%\system32. Ein Administrator kann dieses Standardmäßige Client-Plug-In-DLL-Verzeichnis ändern. Bearbeiten Sie dazu den HKEY_LOCAL_MACHINE\Software\Microsoft\Terminal Server Client\vdllpath Registrierungsschlüssel auf dem Clientcomputer. Dieser Verzeichnispfad kann nicht im UNC-Format angegeben werden.