Dela via


DVC-plugin-registrering

Plugin-programmet för dynamisk virtuell kanal (DVC) registreras för användning av RDC-klienten (Remote Desktop Connection) med någon av följande metoder:

  • Anropa IMsTscAdvancedSettings::p ut_PluginDlls-metoden för Rdp-kontrollen (Remote Desktop Protocol). Flera poster måste vara kommaavgränsade.

  • Skriva plugin-posten till följande plats i registret på datorn där RDC-klientprocessen (Remote Desktop Connection) startas:

    HKEY_CURRENT_USER\Software\Microsoft\Terminal Server Client\Standard\AddIns\unikt plugin-namn

    Not

    Du måste skapa det unika plugin-namnet undernyckel om den inte finns. Det unika plugin-namnet undernyckelnamn är en godtycklig sträng som kan identifiera plugin-programmet. Strängen kan vara valfri kombination av tecken.

     

    Under unikt plugin-namnmåste du lägga till en post som identifierar plugin-programmet.

    Postnamn = namn

    Datatyp = REG_SZ eller REG_EXPAND_SZ

I båda fallen måste postvärdet överensstämma med något av följande format:

"Plug-inDLLName:{CLSID}"

Plugin-programmet är inte nödvändigtvis registrerat i Windows-registret som ett COM-objekt (Component Object Model), men DLL-filen implementeras som ett pågående COM-objekt. RDC-klienten läser in den DLL som anges av Plug-inDLLName- och hämtar COM-objektet direkt med CLSID-.

"Plug-inDLLName"

DLL implementerar funktionen VirtualChannelGetInstance och exporterar den efter namn. RDC-klienten använder funktionen VirtualChannelGetInstance för att hämta IWTSPlugin- gränssnittspekare för alla plugin-program som implementeras av DLL:en.

"{CLSID}"

RDC-klienten instansierar plugin-programmet som ett vanligt COM-objekt med hjälp av CoCreateInstance- med CLSID-.

Not

Plug-inDLLName representerar den fullständiga sökvägen och filnamnet för den .dll filen. Om datatypen är REG_EXPAND_SZkan sökvägen innehålla oexpanderade miljövariabler som expanderas vid körning.

 

När RDC-klienten (Remote Desktop Connection) har slutfört initieringen utför den följande för varje registrerat plugin-program:

  1. Hämta en instans av IWTSPlugin- gränssnitt för varje plugin-program med någon av metoderna som beskrivs ovan.
  2. Anropa metoden Initiera för varje IWTSPlugin--gränssnitt.
  3. Om klienten ansluter flera gånger till samma eller till en annan server kan det finnas flera anrop till metoderna Ansluten och Frånkopplad.
  4. Det sista anropet som plugin-programmet ska hantera är Avslutade. Det är en signal om att RDC-klienten (Remote Desktop Connection) håller på att ta bort plugin-programmet.