Registrierung des DVC-Plug-Ins

Das DVC-Plug-In (Dynamic Virtual Channel) wird mit einer der folgenden Methoden für die Verwendung durch den RDC-Client (Remotedesktopverbindung) registriert:

• Aufrufen der IMsTscAdvancedSettings::p ut_PluginDlls-Methode des RDP-ActiveX-Steuerelements (Remote Desktop Protocol). Mehrere Einträge müssen durch Trennzeichen getrennt werden.

• Schreiben des Plug-In-Eintrags an den folgenden Speicherort in der Registrierung auf dem Computer, auf dem der Remotedesktopverbindungsclientprozess (RDC) gestartet wird:

  HKEY_CURRENT_USER\Software\Microsoft\Terminalserverclient\Standard\Addins\eindeutiger Plug-In-Name

  Hinweis

  Sie müssen den eindeutigen Unterschlüssel für den 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 prozessinternes 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 anhand des Namens. Der RDC-Client verwendet die VirtualChannelGetInstance-Funktion , um IWTSPlugin-Schnittstellenzeiger für alle von der DLL implementierten Plug-Ins abzurufen.

"{CLSID}"

Der RDC-Client instanziiert das Plug-In als reguläres COM-Objekt mithilfe von CoCreateInstance mit der CLSID.

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 Remotedesktopverbindungsclient (RDC) seine Initialisierung abgeschlossen hat, führt er für jedes registrierte Plug-In Folgendes aus:

1. Rufen Sie mithilfe einer der oben beschriebenen Methoden eine instance der IWTSPlugin-Schnittstelle für jedes Plug-In ab.
2. Rufen Sie die Initialize-Methode jeder IWTSPlugin-Schnittstelle auf.
3. Wenn der Client mehrmals eine Verbindung mit demselben oder einem anderen Server herstellt, kann es mehrere Aufrufe der Methoden Verbunden und Getrennt geben.
4. Der letzte Aufruf, den das Plug-In verarbeiten soll, ist Terminated. Es ist ein Signal, dass der Remotedesktopverbindungsclient (RDC) das Plug-In entladen wird.