Compartir a través de

Interfaz IWTSProtocolConnection (wtsprotocol.h)

  • Artículo

[IWTSProtocolConnection ya no está disponible para su uso a partir de Windows Server 2012. En su lugar, use IWRdsProtocolConnection.]

Expone los métodos a los que llama el servicio Servicios de Escritorio remoto para configurar una conexión de cliente. El protocolo debe implementar esta interfaz para controlar las solicitudes de conexión de los clientes. Cuando el agente de escucha de protocolo recibe una solicitud de conexión de un cliente, debe crear un objeto IWTSProtocolConnection y pasarlo al servicio Servicios de Escritorio remoto llamando al método OnConnected . En respuesta, el servicio agrega una referencia al objeto IWTSProtocolConnectionCallback y devuelve un puntero a él. Cuando la conexión ya no es necesaria, el protocolo debe liberar el puntero.

Durante una secuencia de conexión, el servicio Servicios de Escritorio remoto llama a los métodos siguientes en el orden indicado.

  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
Si el servicio Servicios de Escritorio remoto necesita volver a conectarse después de llamar a SessionArbitrationEnumeration, se vuelve a conectar llamando a los métodos siguientes en el orden indicado:
  1. DisconnectNotify (se llama en la nueva sesión que se creó).
  2. NotifySessionId (se llama en la sesión existente).
  3. GetProtocolHandles
  4. ConnectNotify
  5. LogonNotify
Para desconectarse, el servicio Servicios de Escritorio remoto llama a los métodos siguientes en el orden indicado:
  1. DisconnectNotify
  2. Close
El servicio Servicios de Escritorio remoto puede llamar a los métodos siguientes en cualquier momento después de establecer una conexión:

Herencia

La interfaz IWTSProtocolConnection hereda de la interfaz IUnknown . IWTSProtocolConnection también tiene estos tipos de miembros:

Métodos

La interfaz IWTSProtocolConnection tiene estos métodos.

 
IWTSProtocolConnection::AcceptConnection

IWTSProtocolConnection::AcceptConnection ya no está disponible. En su lugar, use IWRdsProtocolConnection::AcceptConnection.
IWTSProtocolConnection::AuthenticateClientToSession

IWTSProtocolConnection::AuthenticateClientToSession ya no está disponible. En su lugar, use IWRdsProtocolConnection::AuthenticateClientToSession.
IWTSProtocolConnection::Close

IWTSProtocolConnection::Close ya no está disponible. En su lugar, use IWRdsProtocolConnection::Close.
IWTSProtocolConnection::ConnectNotify

IWTSProtocolConnection::ConnectNotify ya no está disponible. En su lugar, use IWRdsProtocolConnection::ConnectNotify.
IWTSProtocolConnection::CreateVirtualChannel

IWTSProtocolConnection::CreateVirtualChannel ya no está disponible. En su lugar, use IWRdsProtocolConnection::CreateVirtualChannel.
IWTSProtocolConnection::D isconnectNotify

IWTSProtocolConnection::D isconnectNotify ya no está disponible. En su lugar, use IWRdsProtocolConnection::D isconnectNotify.
IWTSProtocolConnection::GetClientData

IWTSProtocolConnection::GetClientData ya no está disponible. En su lugar, use IWRdsProtocolConnection::GetClientData.
IWTSProtocolConnection::GetLastInputTime

IWTSProtocolConnection::GetLastInputTime ya no está disponible. En su lugar, use IWRdsProtocolConnection::GetLastInputTime.
IWTSProtocolConnection::GetLicenseConnection

IWTSProtocolConnection::GetLicenseConnection ya no está disponible. En su lugar, use IWRdsProtocolConnection::GetLicenseConnection.
IWTSProtocolConnection::GetLogonErrorRedirector

IWTSProtocolConnection::GetLogonErrorRedirector ya no está disponible. En su lugar, use IWRdsProtocolConnection::GetLogonErrorRedirector.
IWTSProtocolConnection::GetProtocolHandles

IWTSProtocolConnection::GetProtocolHandles ya no está disponible.
IWTSProtocolConnection::GetProtocolStatus

IWTSProtocolConnection::GetProtocolStatus ya no está disponible. En su lugar, use IWRdsProtocolConnection::GetProtocolStatus.
IWTSProtocolConnection::GetShadowConnection

IWTSProtocolConnection::GetShadowConnection ya no está disponible. En su lugar, use IWRdsProtocolConnection::GetShadowConnection.
IWTSProtocolConnection::GetUserCredentials

IWTSProtocolConnection::GetUserCredentials ya no está disponible. En su lugar, use IWRdsProtocolConnection::GetUserCredentials.
IWTSProtocolConnection::GetUserData

IWTSProtocolConnection::GetUserData ya no está disponible. En su lugar, use IWRdsProtocolSettings::MergeSettings.
IWTSProtocolConnection::IsUserAllowedToLogon

IWTSProtocolConnection::IsUserAllowedToLogon ya no está disponible. En su lugar, use IWRdsProtocolConnection::IsUserAllowedToLogon.
IWTSProtocolConnection::LogonNotify

IWTSProtocolConnection::LogonNotify ya no está disponible. En su lugar, use IWRdsProtocolConnection::LogonNotify.
IWTSProtocolConnection::NotifySessionId

IWTSProtocolConnection::NotifySessionId ya no está disponible. En su lugar, use IWRdsProtocolConnection::NotifySessionId.
IWTSProtocolConnection::QueryProperty

IWTSProtocolConnection::QueryProperty ya no está disponible. En su lugar, use IWRdsProtocolConnection::QueryProperty.
IWTSProtocolConnection::SendBeep

IWTSProtocolConnection::SendBeep ya no está disponible.
IWTSProtocolConnection::SendPolicyData

IWTSProtocolConnection::SendPolicyData ya no está disponible. En su lugar, use IWRdsProtocolManager::NotifySettingsChange.
IWTSProtocolConnection::SessionArbitrationEnumeration

IWTSProtocolConnection::SessionArbitrationEnumeration ya no está disponible. En su lugar, use IWRdsProtocolConnection::SessionArbitrationEnumeration.
IWTSProtocolConnection::SetErrorInfo

IWTSProtocolConnection::SetErrorInfo ya no está disponible. En su lugar, use IWRdsProtocolConnection::SetErrorInfo.

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2008 R2
Plataforma de destino Windows
Encabezado wtsprotocol.h