IWTSPlugin-Schnittstelle (tsvirtualchannels.h)

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

Der RDC-Client ruft eine instance dieser Schnittstelle ab, indem er entweder das COM-Objekt instanziiert oder die vom Plug-In implementierte VirtualChannelGetInstance-Funktion aufruft. Weitere Informationen zum Abrufen der Instanzen finden Sie unter DVC-Plug-In-Registrierung. In allen Fällen wird dieser instance für die Lebensdauer des Remotedesktopverbindungsclients (RDC) beibehalten.

Als COM-Objekt muss das Plug-In in einem Free-Threading-Modell implementiert werden. Da die IWTSPlugin-Methoden vom Plug-In implementiert werden, muss das Plug-In beachten, dass der Aufruf möglicherweise in verschiedenen Threads eingeht. Die Aufrufe werden immer seriell eintreffen, sodass es unmöglich ist, zwei Aufrufe zu haben, die parallel ausgeführt werden.

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

Vererbung

Die IWTSPlugin-Schnittstelle erbt von der IUnknown-Schnittstelle . IWTSPlugin verfügt auch über folgende Membertypen:

Methoden

Die IWTSPlugin-Schnittstelle verfügt über diese Methoden.

IWTSPlugin::Connected Benachrichtigt das Plug-In, dass der Remotedesktopverbindungsclient (RDC) erfolgreich eine Verbindung mit dem Remotedesktop-Sitzungshostserver (RD-Sitzungshost) hergestellt hat.
IWTSPlugin::D isconnected Benachrichtigt das Plug-In, dass der Remotedesktopverbindungsclient (RDC) die Verbindung mit dem Remotedesktop-Sitzungshostserver (RD-Sitzungshost) getrennt hat.
IWTSPlugin::Initialize Wird für den ersten Aufruf verwendet, der vom Client an das Plug-In erfolgt.
IWTSPlugin::Terminated Benachrichtigt das Plug-In, dass der Remotedesktopverbindungsclient (RDC) beendet wurde.

Hinweise

Die IWTSPlugin-Schnittstelle wird von %System32%\webauthn.dll implementiert, um die WebAuthn-Umleitungsfunktion für Remotedesktop zu aktivieren. Rufen Sie eine instance dieser Schnittstelle ab, indem Sie VirtualChannelGetInstance aufrufen, das ebenfalls von webauthn.dll bereitgestellt wird.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	tsvirtualchannels.h