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:

  1. Rufen Sie mithilfe einer der oben beschriebenen Methoden eine Instanz 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 Connected und Disconnected geben.
  4. 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.