Interfaccia IWTSProtocolConnection (wtsprotocol.h)

[IWTSProtocolConnection non è più disponibile per l'uso a partire da Windows Server 2012. Usare invece IWRdsProtocolConnection.]

Espone i metodi chiamati dal servizio Servizi Desktop remoto per configurare una connessione client. Il protocollo deve implementare questa interfaccia per gestire le richieste di connessione dai client. Quando il listener del protocollo riceve una richiesta di connessione da un client, deve creare un oggetto IWTSProtocolConnection e passarlo al servizio Servizi Desktop remoto chiamando il metodo OnConnected . In risposta, il servizio aggiunge un riferimento all'oggetto IWTSProtocolConnectionCallback e restituisce un puntatore. Quando la connessione non è più necessaria, il protocollo deve rilasciare il puntatore.

Durante una sequenza di connessione, i metodi seguenti vengono chiamati dal servizio Servizi Desktop remoto nell'ordine elencato.

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

Se il servizio Servizi Desktop remoto deve riconnettersi dopo aver chiamato SessionArbitrationEnumeration, si riconnette chiamando i metodi seguenti nell'ordine elencato:

1. DisconnectNotify (Chiamato nella nuova sessione creata).
2. NotifySessionId (chiamato nella sessione esistente).
3. GetProtocolHandles
4. ConnectNotify
5. LogonNotify

Per disconnettersi, il servizio Servizi Desktop remoto chiama i metodi seguenti nell'ordine elencato:

1. DisconnectNotify
2. Close

Il servizio Servizi Desktop remoto può chiamare i metodi seguenti in qualsiasi momento dopo che è stata stabilita una connessione:

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

Ereditarietà

L'interfaccia IWTSProtocolConnection eredita dall'interfaccia IUnknown . IWTSProtocolConnection include anche questi tipi di membri:

Metodi

L'interfaccia IWTSProtocolConnection include questi metodi.

IWTSProtocolConnection::AcceptConnection IWTSProtocolConnection::AcceptConnection non è più disponibile. Usare invece IWRdsProtocolConnection::AcceptConnection.
IWTSProtocolConnection::AuthenticateClientToSession IWTSProtocolConnection::AuthenticateClientToSession non è più disponibile. Usare invece IWRdsProtocolConnection::AuthenticateClientToSession.
IWTSProtocolConnection::Close IWTSProtocolConnection::Close non è più disponibile. Usare invece IWRdsProtocolConnection::Close.
IWTSProtocolConnection::ConnectNotify IWTSProtocolConnection::ConnectNotify non è più disponibile. Usare invece IWRdsProtocolConnection::ConnectNotify.
IWTSProtocolConnection::CreateVirtualChannel IWTSProtocolConnection::CreateVirtualChannel non è più disponibile. Usare invece IWRdsProtocolConnection::CreateVirtualChannel.
IWTSProtocolConnection::D isconnectNotify IWTSProtocolConnection::D isconnectNotify non è più disponibile. Usare invece IWRdsProtocolConnection::D isconnectNotify.
IWTSProtocolConnection::GetClientData IWTSProtocolConnection::GetClientData non è più disponibile. Usare invece IWRdsProtocolConnection::GetClientData.
IWTSProtocolConnection::GetLastInputTime IWTSProtocolConnection::GetLastInputTime non è più disponibile. Usare invece IWRdsProtocolConnection::GetLastInputTime.
IWTSProtocolConnection::GetLicenseConnection IWTSProtocolConnection::GetLicenseConnection non è più disponibile. Usare invece IWRdsProtocolConnection::GetLicenseConnection.
IWTSProtocolConnection::GetLogonErrorRedirector IWTSProtocolConnection::GetLogonErrorRedirector non è più disponibile. Usare invece IWRdsProtocolConnection::GetLogonErrorRedirector.
IWTSProtocolConnection::GetProtocolHandles IWTSProtocolConnection::GetProtocolHandles non è più disponibile.
IWTSProtocolConnection::GetProtocolStatus IWTSProtocolConnection::GetProtocolStatus non è più disponibile. Usare invece IWRdsProtocolConnection::GetProtocolStatus.
IWTSProtocolConnection::GetShadowConnection IWTSProtocolConnection::GetShadowConnection non è più disponibile. Usare invece IWRdsProtocolConnection::GetShadowConnection.
IWTSProtocolConnection::GetUserCredentials IWTSProtocolConnection::GetUserCredentials non è più disponibile. Usare invece IWRdsProtocolConnection::GetUserCredentials.
IWTSProtocolConnection::GetUserData IWTSProtocolConnection::GetUserData non è più disponibile. Usare invece IWRdsProtocolSettings::MergeSettings.
IWTSProtocolConnection::IsUserAllowedToLogon IWTSProtocolConnection::IsUserAllowedToLogon non è più disponibile. Usare invece IWRdsProtocolConnection::IsUserAllowedToLogon.
IWTSProtocolConnection::LogonNotify IWTSProtocolConnection::LogonNotify non è più disponibile. Usare invece IWRdsProtocolConnection::LogonNotify.
IWTSProtocolConnection::NotifySessionId IWTSProtocolConnection::NotifySessionId non è più disponibile. Usare invece IWRdsProtocolConnection::NotifySessionId.
IWTSProtocolConnection::QueryProperty IWTSProtocolConnection::QueryProperty non è più disponibile. Usare invece IWRdsProtocolConnection::QueryProperty.
IWTSProtocolConnection::SendBeep IWTSProtocolConnection::SendBeep non è più disponibile.
IWTSProtocolConnection::SendPolicyData IWTSProtocolConnection::SendPolicyData non è più disponibile. Usare invece IWRdsProtocolManager::NotifySettingsChange.
IWTSProtocolConnection::SessionArbitrationEnumeration IWTSProtocolConnection::SessionArbitrationEnumeration non è più disponibile. Usare invece IWRdsProtocolConnection::SessionArbitrationEnumeration.
IWTSProtocolConnection::SetErrorInfo IWTSProtocolConnection::SetErrorInfo non è più disponibile. Usare invece IWRdsProtocolConnection::SetErrorInfo.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 R2
Piattaforma di destinazione	Windows
Intestazione	wtsprotocol.h