DVC-Plug-In-Registrierung
Das DVC-Plug-In (Dynamischer virtueller Kanal) wird für die Verwendung durch den rdc-Client (Remotedesktopverbindung) mit einer der folgenden Methoden registriert:
Aufrufen der IMsTscAdvancedSettings::p ut _ PluginDlls-Methode des Remotedesktopprotokoll (RDP) ActiveX-Steuerelements. Mehrere Einträge müssen durch Kommas getrennt werden.
Schreiben des Plug-In-Eintrags an den folgenden Speicherort in der Registrierung auf dem Computer, auf dem der Remotedesktopverbindung-Clientprozess gestartet wird:
HKEY _ CURRENT _ USER \ Software \ Microsoft \ Terminal Server Client \ Default \ AddIns \ unique plug-in name
Hinweis
Sie müssen den Unterschlüssel für den eindeutigen Plug-In-Namen erstellen, wenn er nicht vorhanden ist. Der eindeutige Unterschlüsselname des Plug-Ins ist eine beliebige Zeichenfolge, die das Plug-In identifizieren kann. Die Zeichenfolge kann eine beliebige Kombination von Zeichen sein.
Unter dem eindeutigen Plug-In-Namen müssen Sie einen Eintrag hinzufügen, der das Plug-In identifiziert.
Eintragsname = Name
Datentyp = REG _ SZ oder REG EXPAND _ _ SZ
In beiden Fällen muss der Eintragswert einem der folgenden Formate entsprechen:
-
"Plug-InDLLName:{CLSID}"
-
Das Plug-In ist nicht unbedingt in der Windows-Registrierung als COM-Objekt (Component Object Model) registriert, aber die DLL wird als PROZESS-COM-Objekt implementiert. Der RDC-Client lädt die durch Plug-InDLLName angegebene DLL und ruft das COM-Objekt direkt mithilfe von CLSID ab.
-
"Plug-InDLLName"
-
Die DLL implementiert die VirtualChannelGetInstance-Funktion und exportiert sie nach Namen. Der RDC-Client verwendet die VirtualChannelGetInstance-Funktion, um IWTSPlugin-Schnittstellenzeiger für alle Plug-Ins abzurufen, die von der DLL implementiert werden.
-
"{CLSID}"
-
Der RDC-Client instanziiert das Plug-In mithilfe von CoCreateInstance mit der CLSID als reguläres COM-Objekt.
Hinweis
Plug-InDLLName stellt den vollständigen Pfad und Dateinamen der .dll Datei dar. Wenn der Datentyp REG _ EXPAND _ SZ ist, kann der Pfad nicht erweiterte Umgebungsvariablen enthalten, die zur Laufzeit erweitert werden.
Wenn der Remotedesktopverbindung-Client (RDC) seine Initialisierung beendet, führt er für jedes registrierte Plug-In Folgendes aus:
- Rufen Sie mithilfe einer der oben beschriebenen Methoden eine Instanz der IWTSPlugin-Schnittstelle für jedes Plug-In ab.
- Rufen Sie die Initialize-Methode jeder IWTSPlugin-Schnittstelle auf.
- Wenn der Client mehrmals eine Verbindung mit demselben oder einem anderen Server herstellt, kann es mehrere Aufrufe der Methoden Connected und Disconnected geben.
- Der letzte Aufruf, den das Plug-In verarbeiten soll, ist Beendet. Es ist ein Signal, dass der rdc-Client (Remotedesktopverbindung) das Plug-In entladen wird.