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 |