Freigeben über


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 Session Broker) 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 die folgenden Typen von Mitgliedern:

Methodik

Die IWTSSBPlugin-Schnittstelle hat 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 darüber, dass es von Terminal Services Session Broker (TS Session Broker) zerstört werden soll.
IWTSSBPlugin::WTSSBX_GetMostSuitableServer

Gibt die ID des Servers zurück, an den der Terminal services Session Broker (TS Session Broker) die eingehende Verbindung leiten soll.
IWTSSBPlugin::WTSSBX_GetUserExternalSession

Leitet eine eingehende Verbindung zu einer Computerressource 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 über die 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. anmeldung, Abmelden, Trennen oder erneute Verbindung, in der Sitzung aufgetreten ist.

Bemerkungen

DER TS-Sitzungsbroker ruft die WTSSBX_GetUserExternalSession-Methode auf, sodass das Plug-In eine eingehende Verbindung zu einem Computer leiten 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 zu einem Computer leiten kann, der zu einer Farm im TS-Sitzungsbroker gehört.

Diese Methoden verweisen auf einen einzelnen Server in der Farm mithilfe der eindeutigen MachineId , die dem Server vom TS-Sitzungsbroker zugewiesen ist. 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
Mindestens unterstützter Client Nicht unterstützt
Mindestanforderungen für unterstützte Server Windows Server 2008
Zielplattform Fenster
Header tssbx.h

Siehe auch

ITsSbPlugin

Erweiterbarkeit des Remotedesktopverbindungsbrokers