Delen via

Registratie van DVC-invoegtoepassing

  • Artikel

De DVC-invoegtoepassing (Dynamic Virtual Channel) is geregistreerd voor gebruik door de RDC-client (Remote Desktop Connection) met behulp van een van de volgende methoden:

  • Het aanroepen van de IMsTscAdvancedSettings::p ut_PluginDlls methode van het ActiveX-besturingselement Remote Desktop Protocol (RDP). Meerdere vermeldingen moeten door komma's worden gescheiden.

  • Schrijf de invoegtoepassingsvermelding naar de volgende locatie in het register op de computer waarop het RDC-clientproces (Remote Desktop Connection) is gestart:

    HKEY_CURRENT_USER\Software\Microsoft\Terminal Server Client\Default\AddIns\unieke invoegtoepassingsnaam

    Notitie

    U moet de unieke invoegtoepassingsnaam maken subsleutel als deze niet bestaat. De unieke naam van de invoegtoepassing subsleutelnaam is een willekeurige tekenreeks waarmee de invoegtoepassing kan worden geïdentificeerd. De tekenreeks kan elke combinatie van tekens zijn.

     

    Onder unieke invoegtoepassingsnaammoet u een vermelding toevoegen waarmee de invoegtoepassing wordt geïdentificeerd.

    Vermeldingsnaam = naam

    Gegevenstype = REG_SZ of REG_EXPAND_SZ

In beide gevallen moet de invoerwaarde voldoen aan een van de volgende indelingen:

"Plug-inDLLName:{CLSID}"

De invoegtoepassing is niet noodzakelijkerwijs geregistreerd in het Windows-register als com-object (Component Object Model), maar de DLL wordt geïmplementeerd als een in-process COM-object. De RDC-client laadt het DLL-bestand dat is opgegeven door Plug-inDLLName en haalt het COM-object rechtstreeks op met behulp van CLSID-.

"Plug-inDLLName"

Het DLL-bestand implementeert de VirtualChannelGetInstance- functie en exporteert deze op naam. De RDC-client gebruikt de functie VirtualChannelGetInstance om IWTSPlugin interfaceaanwijzers te verkrijgen voor alle invoegtoepassingen die door het DLL-bestand zijn geïmplementeerd.

{CLSID}"

De RDC-client instantiëren de invoegtoepassing als een gewoon COM-object met behulp van CoCreateInstance met de CLSID-.

Notitie

Plug-inDLLName staat voor het volledige pad en de bestandsnaam van het .dll-bestand. Als het gegevenstype is REG_EXPAND_SZ, kan het pad niet-uitgevouwen omgevingsvariabelen bevatten die tijdens runtime worden uitgebreid.

 

Wanneer de RDC-client (Remote Desktop Connection) de initialisatie heeft voltooid, wordt het volgende uitgevoerd voor elke geregistreerde invoegtoepassing:

  1. Verkrijg een exemplaar van de IWTSPlugin interface voor elke invoegtoepassing met behulp van een van de hierboven beschreven methoden.
  2. Roep de initialiseer methode van elke IWTSPlugin interface.
  3. Als de client meerdere keren verbinding maakt met dezelfde of een andere server, zijn er mogelijk meerdere aanroepen naar de verbonden en niet-verbonden methoden.
  4. De laatste aanroep die de invoegtoepassing moet verwerken, is beëindigd. Het is een signaal dat de RDC-client (Remote Desktop Connection) op het punt staat om de invoegtoepassing te verwijderen.