(tssbx.h) IWTSSBPlugin 介面
[Windows Server 2008 R2 之後不支援 IWTSSBPlugin 介面。 從 Windows Server 2012 開始,請使用 ITsSbPlugin 介面。]
用來擴充終端機服務會話訊息代理程式 (TS 會話訊息代理程式) 的功能。 當您想要提供可覆寫 TS 會話代理人重新導向邏輯的外掛程式時,請實作此介面。
繼承
IWTSSBPlugin 介面繼承自 IUnknown 介面。 IWTSSBPlugin 也有下列類型的成員:
方法
IWTSSBPlugin 介面具有這些方法。
IWTSSBPlugin::Initialize 初始化外掛程式,並傳回值,指出外掛程式的重新導向功能。 |
IWTSSBPlugin::Terminated 通知外掛程式即將由終端機服務會話訊息代理程式 (TS 會話訊息代理程式) 終結。 |
IWTSSBPlugin::WTSSBX_GetMostSuitableServer 傳回終端機服務會話訊息代理程式 (TS 工作階段訊息代理程式) 應導向連入連線的伺服器識別碼。 |
IWTSSBPlugin::WTSSBX_GetUserExternalSession 藉由提供包含資源相關信息的WTSSBX_MACHINE_CONNECT_INFO結構,將連入連線重新導向至運算資源,例如虛擬機、刀鋒視窗伺服器,或甚至是使用者自己的公司桌面。 |
IWTSSBPlugin::WTSSBX_MachineChangeNotification 通知外掛程式伺服器環境中發生變更。 |
IWTSSBPlugin::WTSSBX_SessionChangeNotification 通知外掛程式在會話中發生變更,例如登入、註銷、中斷聯機或重新連線。 |
備註
TS 會話訊息代理程式會呼叫 WTSSBX_GetUserExternalSession 方法,讓外掛程式可以將連入連線導向 TS 會話代理人中不屬於伺服器數位的電腦。
或者,TS 會話代理人會呼叫 WTSSBX_GetMostSuitableServer 方法,讓外掛程式可以將連入連線導向至 TS 會話代理人中屬於伺服器數位的電腦。
這些方法會使用 TS 會話訊息代理程式指派給伺服器的唯一 MachineId ,參考伺服器陣列中的個別伺服器。 當伺服器在 TS 會話代理人中加入伺服器數位列時,TS 會話訊息代理程式會呼叫 WTSSBX_MachineChangeNotification 方法來通知外掛程式變更,並將新伺服器的 MachineId 傳遞至外掛程式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | tssbx.h |