IWTSSBPlugin-Schnittstelle (tssbx.h)

[Die IWTSSBPlugin-Schnittstelle wird nach Windows Server 2008 R2 nicht unterstützt. Ab Windows Server 2012 verwenden Sie bitte die ITsSbPlugin-Schnittstelle.]

Wird verwendet, um die Funktionen des Terminaldienste-Sitzungsbrokers (TS-Sitzungsbroker) zu erweitern. Implementieren Sie diese Schnittstelle, wenn Sie ein Plug-In bereitstellen möchten, das die Umleitungslogik des TS-Sitzungsbrokers überschreibt.

Vererbung

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

Methoden

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

IWTSSBPlugin::Initialize Initialisiert das Plug-In und gibt einen Wert zurück, der die Umleitungsfunktionen des Plug-Ins angibt.
IWTSSBPlugin::Terminated Benachrichtigt das Plug-In, dass es vom Terminaldienste-Sitzungsbroker (TS-Sitzungsbroker) zerstört werden soll.
IWTSSBPlugin::WTSSBX_GetMostSuitableServer Gibt die ID des Servers zurück, an den der Terminaldienste-Sitzungsbroker (TS-Sitzungsbroker) die eingehende Verbindung leiten soll.
IWTSSBPlugin::WTSSBX_GetUserExternalSession Leitet eine eingehende Verbindung an eine Computingressource um, z. B. einen virtuellen Computer, einen Blattserver oder sogar den eigenen Unternehmensdesktop des Benutzers, indem eine WTSSBX_MACHINE_CONNECT_INFO-Struktur bereitgestellt wird, die Informationen zur Ressource enthält.
IWTSSBPlugin::WTSSBX_MachineChangeNotification Benachrichtigt das Plug-In, dass eine Änderung in der Serverumgebung aufgetreten ist.
IWTSSBPlugin::WTSSBX_SessionChangeNotification Benachrichtigt das Plug-In, dass eine Änderung, z. B. eine Anmeldung, Abmeldung, Trennung oder erneute Verbindung, in der Sitzung erfolgt ist.

Hinweise

Der TS-Sitzungsbroker ruft die WTSSBX_GetUserExternalSession-Methode auf, damit das Plug-In eine eingehende Verbindung an einen Computer weiterleiten kann, der nicht zu einer Farm im TS-Sitzungsbroker gehört.

Alternativ ruft der TS-Sitzungsbroker die WTSSBX_GetMostSuitableServer-Methode auf, damit das Plug-In eine eingehende Verbindung an einen Computer weiterleiten kann, der zu einer Farm im TS-Sitzungsbroker gehört.

Diese Methoden verweisen mithilfe der eindeutigen MachineId , die dem Server vom TS-Sitzungsbroker zugewiesen ist, auf einen einzelnen Server in der Farm. Wenn ein Server einer Farm im TS-Sitzungsbroker beitritt, ruft der TS-Sitzungsbroker die WTSSBX_MachineChangeNotification-Methode auf, um das Plug-In über die Änderung zu benachrichtigen und die MachineId des neuen Servers an das Plug-In zu übergeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	tssbx.h

Weitere Informationen

ITsSbPlugin

Erweiterbarkeit des Remotedesktop-Verbindungsbrokers