IWTSProtocolConnection 接口 (wtsprotocol.h)

[自Windows Server 2012起，IWTSProtocolConnection 不再可供使用。 请改用 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. 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