Share via


Interface IWTSProtocolConnection (wtsprotocol.h)

[IWTSProtocolConnection não está mais disponível para uso a partir de Windows Server 2012. Em vez disso, use IWRdsProtocolConnection.]

Expõe métodos chamados pelo serviço de Serviços de Área de Trabalho Remota para configurar uma conexão de cliente. Seu protocolo deve implementar essa interface para lidar com solicitações de conexão de clientes. Quando o ouvinte de protocolo recebe uma solicitação de conexão de um cliente, ele deve criar um objeto IWTSProtocolConnection e passá-lo para o serviço de Serviços de Área de Trabalho Remota chamando o método OnConnected . Em resposta, o serviço adiciona uma referência ao objeto IWTSProtocolConnectionCallback e retorna um ponteiro para ele. Quando a conexão não for mais necessária, o protocolo deverá liberar o ponteiro.

Durante uma sequência de conexão, os métodos a seguir são chamados pelo serviço de Serviços de Área de Trabalho Remota na ordem listada.

  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 o serviço de Serviços de Área de Trabalho Remota precisar se reconectar depois de chamar SessionArbitrationEnumeration, ele se reconectará chamando os seguintes métodos na ordem listada:
  1. DisconnectNotify (chamado na nova sessão que foi criada.)
  2. NotifySessionId (chamado na sessão existente.)
  3. GetProtocolHandles
  4. ConnectNotify
  5. LogonNotify
Para se desconectar, o serviço Serviços de Área de Trabalho Remota chama os seguintes métodos na ordem listada:
  1. DisconnectNotify
  2. Fechar
O serviço Serviços de Área de Trabalho Remota pode chamar os seguintes métodos a qualquer momento depois que uma conexão tiver sido estabelecida:

Herança

A interface IWTSProtocolConnection herda da interface IUnknown . IWTSProtocolConnection também tem estes tipos de membros:

Métodos

A interface IWTSProtocolConnection tem esses métodos.

 
IWTSProtocolConnection::AcceptConnection

IWTSProtocolConnection::AcceptConnection não está mais disponível. Em vez disso, use IWRdsProtocolConnection::AcceptConnection.
IWTSProtocolConnection::AuthenticateClientToSession

IWTSProtocolConnection::AuthenticateClientToSession não está mais disponível. Em vez disso, use IWRdsProtocolConnection::AuthenticateClientToSession.
IWTSProtocolConnection::Close

IWTSProtocolConnection::Close não está mais disponível. Em vez disso, use IWRdsProtocolConnection::Close.
IWTSProtocolConnection::ConnectNotify

IWTSProtocolConnection::ConnectNotify não está mais disponível. Em vez disso, use IWRdsProtocolConnection::ConnectNotify.
IWTSProtocolConnection::CreateVirtualChannel

IWTSProtocolConnection::CreateVirtualChannel não está mais disponível. Em vez disso, use IWRdsProtocolConnection::CreateVirtualChannel.
IWTSProtocolConnection::D isconnectNotify

IWTSProtocolConnection::D isconnectNotify não está mais disponível. Em vez disso, use IWRdsProtocolConnection::D isconnectNotify.
IWTSProtocolConnection::GetClientData

IWTSProtocolConnection::GetClientData não está mais disponível. Em vez disso, use IWRdsProtocolConnection::GetClientData.
IWTSProtocolConnection::GetLastInputTime

IWTSProtocolConnection::GetLastInputTime não está mais disponível. Em vez disso, use IWRdsProtocolConnection::GetLastInputTime.
IWTSProtocolConnection::GetLicenseConnection

IWTSProtocolConnection::GetLicenseConnection não está mais disponível. Em vez disso, use IWRdsProtocolConnection::GetLicenseConnection.
IWTSProtocolConnection::GetLogonErrorRedirector

IWTSProtocolConnection::GetLogonErrorRedirector não está mais disponível. Em vez disso, use IWRdsProtocolConnection::GetLogonErrorRedirector.
IWTSProtocolConnection::GetProtocolHandles

IWTSProtocolConnection::GetProtocolHandles não está mais disponível.
IWTSProtocolConnection::GetProtocolStatus

IWTSProtocolConnection::GetProtocolStatus não está mais disponível. Em vez disso, use IWRdsProtocolConnection::GetProtocolStatus.
IWTSProtocolConnection::GetShadowConnection

IWTSProtocolConnection::GetShadowConnection não está mais disponível. Em vez disso, use IWRdsProtocolConnection::GetShadowConnection.
IWTSProtocolConnection::GetUserCredentials

IWTSProtocolConnection::GetUserCredentials não está mais disponível. Em vez disso, use IWRdsProtocolConnection::GetUserCredentials.
IWTSProtocolConnection::GetUserData

IWTSProtocolConnection::GetUserData não está mais disponível. Em vez disso, use IWRdsProtocolSettings::MergeSettings.
IWTSProtocolConnection::IsUserAllowedToLogon

IWTSProtocolConnection::IsUserAllowedToLogon não está mais disponível. Em vez disso, use IWRdsProtocolConnection::IsUserAllowedToLogon.
IWTSProtocolConnection::LogonNotify

IWTSProtocolConnection::LogonNotify não está mais disponível. Em vez disso, use IWRdsProtocolConnection::LogonNotify.
IWTSProtocolConnection::NotifySessionId

IWTSProtocolConnection::NotifySessionId não está mais disponível. Em vez disso, use IWRdsProtocolConnection::NotifySessionId.
IWTSProtocolConnection::QueryProperty

IWTSProtocolConnection::QueryProperty não está mais disponível. Em vez disso, use IWRdsProtocolConnection::QueryProperty.
IWTSProtocolConnection::SendBeep

IWTSProtocolConnection::SendBeep não está mais disponível.
IWTSProtocolConnection::SendPolicyData

IWTSProtocolConnection::SendPolicyData não está mais disponível. Em vez disso, use IWRdsProtocolManager::NotifySettingsChange.
IWTSProtocolConnection::SessionArbitrationEnumeration

IWTSProtocolConnection::SessionArbitrationEnumeration não está mais disponível. Em vez disso, use IWRdsProtocolConnection::SessionArbitrationEnumeration.
IWTSProtocolConnection::SetErrorInfo

IWTSProtocolConnection::SetErrorInfo não está mais disponível. Em vez disso, use IWRdsProtocolConnection::SetErrorInfo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2008 R2
Plataforma de Destino Windows
Cabeçalho wtsprotocol.h