IWTSProtocolConnection 介面 (wtsprotocol.h)

[IWTSProtocolConnection 已不再可供 Windows Server 2012 使用。 請改用 IWRdsProtocolConnection。]

公開遠端桌面服務呼叫的方法，以設定用戶端連線。 您的通訊協議必須實作此介面，才能處理來自客戶端的連線要求。 當通訊協定接聽程式收到來自用戶端的連線要求時，它必須建立 IWTSProtocolConnection 物件，並藉由呼叫 OnConnected 方法將它傳遞至遠端桌面服務服務。 為了回應，服務會將參考新增至 IWTSProtocolConnectionCallback 物件，並傳回它的指標。 當不再需要連接時，通訊協議必須釋放指標。

在聯機順序期間，遠端桌面服務會依列出的順序呼叫下列方法。

1. GetLogonErrorRedirector
2. SendPolicyData
3. AcceptConnection
4. GetClientData
5. GetUserCredentials
6. GetLicenseConnection
7. AuthenticateClientToSession
8. NotifySessionId
9. GetProtocolHandles
10. ConnectNotify
11. IsUserAllowedToLogon
12. SessionArbitrationEnumeration
13. LogonNotify
14. GetUserData

如果遠端桌面服務服務需要在呼叫 SessionArbitrationEnumeration 之後重新連線，它會依列出的順序呼叫下列方法重新連線：

1. DisconnectNotify (在已建立的新會話上呼叫。)
2. 在現有的 session.) 上呼叫 NotifySessionId (
3. GetProtocolHandles
4. ConnectNotify
5. LogonNotify

若要中斷連線，遠端桌面服務服務會依列出的順序呼叫下列方法：

1. DisconnectNotify
2. 關閉

遠端桌面服務服務可以在建立連線之後隨時呼叫下列方法：

• GetProtocolStatus
• GetLastInputTime
• SetErrorInfo
• SendBeep
• CreateVirtualChannel
• QueryProperty
• GetShadowConnection

繼承

IWTSProtocolConnection 介面繼承自 IUnknown 介面。 IWTSProtocolConnection 也有下列類型的成員：

方法

IWTSProtocolConnection 介面具有這些方法。

IWTSProtocolConnection：：AcceptConnection 不再提供 IWTSProtocolConnection：：AcceptConnection。 請改用 IWRdsProtocolConnection：：AcceptConnection。
IWTSProtocolConnection：：AuthenticateClientToSession 不再提供 IWTSProtocolConnection：：AuthenticateClientToSession。 請改用 IWRdsProtocolConnection：：AuthenticateClientToSession。
IWTSProtocolConnection：：Close 不再提供 IWTSProtocolConnection：：Close。 請改用 IWRdsProtocolConnection：：Close。
IWTSProtocolConnection：：ConnectNotify 不再提供 IWTSProtocolConnection：：ConnectNotify。 請改用 IWRdsProtocolConnection：：ConnectNotify。
IWTSProtocolConnection：：CreateVirtualChannel 不再提供 IWTSProtocolConnection：：CreateVirtualChannel。 請改用 IWRdsProtocolConnection：：CreateVirtualChannel。
IWTSProtocolConnection：:D isconnectNotify 不再提供 IWTSProtocolConnection：:D isconnectNotify。 請改用 IWRdsProtocolConnection：:D isconnectNotify。
IWTSProtocolConnection：：GetClientData 不再提供 IWTSProtocolConnection：：GetClientData。 請改用 IWRdsProtocolConnection：：GetClientData。
IWTSProtocolConnection：：GetLastInputTime 不再提供 IWTSProtocolConnection：：GetLastInputTime。 請改用 IWRdsProtocolConnection：：GetLastInputTime。
IWTSProtocolConnection：：GetLicenseConnection 不再提供 IWTSProtocolConnection：：GetLicenseConnection。 請改用 IWRdsProtocolConnection：：GetLicenseConnection。
IWTSProtocolConnection：：GetLogonErrorRedirector 不再提供 IWTSProtocolConnection：：GetLogonErrorRedirector。 請改用 IWRdsProtocolConnection：：GetLogonErrorRedirector。
IWTSProtocolConnection：：GetProtocolHandles 不再提供 IWTSProtocolConnection：：GetProtocolHandles。
IWTSProtocolConnection：：GetProtocolStatus 不再提供 IWTSProtocolConnection：：GetProtocolStatus。 請改用 IWRdsProtocolConnection：：GetProtocolStatus。
IWTSProtocolConnection：：GetShadowConnection 不再提供 IWTSProtocolConnection：：GetShadowConnection。 請改用 IWRdsProtocolConnection：：GetShadowConnection。
IWTSProtocolConnection：：GetUserCredentials 不再提供 IWTSProtocolConnection：：GetUserCredentials。 請改用 IWRdsProtocolConnection：：GetUserCredentials。
IWTSProtocolConnection：：GetUserData 不再提供 IWTSProtocolConnection：：GetUserData。 請改用 IWRdsProtocolSettings：：MergeSettings。
IWTSProtocolConnection：：IsUserAllowedToLogon 不再提供 IWTSProtocolConnection：：IsUserAllowedToLogon。 請改用 IWRdsProtocolConnection：：IsUserAllowedToLogon。
IWTSProtocolConnection：：LogonNotify 不再提供 IWTSProtocolConnection：：LogonNotify。 請改用 IWRdsProtocolConnection：：LogonNotify。
IWTSProtocolConnection：：NotifySessionId 不再提供 IWTSProtocolConnection：：NotifySessionId。 請改用 IWRdsProtocolConnection：：NotifySessionId。
IWTSProtocolConnection：：QueryProperty 不再提供 IWTSProtocolConnection：：QueryProperty。 請改用 IWRdsProtocolConnection：：QueryProperty。
IWTSProtocolConnection：：SendBeep 不再提供 IWTSProtocolConnection：：SendBeep。
IWTSProtocolConnection：：SendPolicyData 不再提供 IWTSProtocolConnection：：SendPolicyData。 請改用 IWRdsProtocolManager：：NotifySettingsChange。
IWTSProtocolConnection：：SessionArbitrationEnumeration 不再提供 IWTSProtocolConnection：：SessionArbitrationEnumeration。 請改用 IWRdsProtocolConnection：：SessionArbitrationEnumeration。
IWTSProtocolConnection：：SetErrorInfo 不再提供 IWTSProtocolConnection：：SetErrorInfo。 請改用 IWRdsProtocolConnection：：SetErrorInfo。

規格需求

需求	值
最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2008 R2
目標平台	Windows
標頭	wtsprotocol.h