(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

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