IWTSPlugin-Schnittstelle (tsvirtualchannels.h)

Ermöglicht das Laden des RDC-Client-Plug-Ins (RemoteDesktopverbindung) durch den REMOTEdesktopverbindungsclient. Die Schnittstelle wird vom Plug-In implementiert und vom RDC-Client abgerufen und verwaltet.

Der RDC-Client ruft eine Instanz dieser Schnittstelle ab, indem entweder das COM-Objekt instanziiert wird, oder indem die vom Plug-In implementierte VirtualChannelGetInstance-Funktion aufgerufen wird. Weitere Informationen dazu, wie die Instanzen abgerufen werden, finden Sie unter DVC-Plug-In-Registrierung. In allen Fällen wird diese Instanz für die Lebensdauer des Remotedesktop Connection (RDC)-Clients beibehalten.

Als COM-Objekt muss das Plug-In in einem Freithreadingmodell implementiert werden. Da die IWTSPlugin-Methoden vom Plug-In implementiert werden, muss das Plug-In beachten, dass der Aufruf möglicherweise in verschiedenen Threads eingehen kann. Die Aufrufe werden immer seriell eingehen, sodass es unmöglich ist, zwei Aufrufe parallel auszuführen.

Die Implementierung sollte diese Aufrufe nicht blockieren, da dadurch andere eingehende Verbindungen oder Daten für vorhandene Verbindungen blockiert werden können.

Vererbung

Die IWTSPlugin-Schnittstelle erbt von der IUnknown-Schnittstelle . IWTSPlugin hat auch folgende Typen von Mitgliedern:

Methodik

Die IWTSPlugin-Schnittstelle hat diese Methoden.

 
IWTSPlugin::Connected

Benachrichtigt das Plug-In, dass der Remotedesktopverbindungsclient (RDC) erfolgreich mit dem Remotedesktopsitzungshostserver (RD Session Host) verbunden wurde.
IWTSPlugin::D isconnected

Benachrichtigt das Plug-In, dass der Remotedesktopverbindungsclient (RDC) vom Remotedesktopsitzungshost (RD Session Host) getrennt wurde.
IWTSPlugin::Initialize

Wird für den ersten Aufruf verwendet, der vom Client an das Plug-In getätigt wird.
IWTSPlugin::Terminated

Benachrichtigt das Plug-In, dass der Remotedesktopverbindungsclient (RDC) beendet wurde.

Bemerkungen

Die schnittstelle IWTSPlugin wird von %System32%\webauthn.dll implementiert, um die Remotedesktop WebAuthn-Umleitungsfunktionalität zu aktivieren. Rufen Sie eine Instanz dieser Schnittstelle durch Aufrufen der VirtualChannelGetInstance-Funktion ab, die auch von webauthn.dllbereitgestellt wird.

Requirements

Anforderung Wert
Mindestens unterstützter Client Windows Vista
Mindestanforderungen für unterstützte Server Windows Server 2008
Zielplattform Windows
Header tsvirtualchannels.h