共用方式為


(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

另請參閱

ITsSbPlugin

遠端桌面連線代理人擴充性