Partager via

Interface IWTSProtocolConnection (wtsprotocol.h)

  • Article

[IWTSProtocolConnection n’est plus disponible depuis Windows Server 2012. Utilisez plutôt IWRdsProtocolConnection.]

Expose les méthodes appelées par le service Services Bureau à distance pour configurer une connexion cliente. Votre protocole doit implémenter cette interface pour gérer les demandes de connexion des clients. Lorsque l’écouteur de protocole reçoit une demande de connexion d’un client, il doit créer un objet IWTSProtocolConnection et le transmettre au service Services Bureau à distance en appelant la méthode OnConnected . En réponse, le service ajoute une référence à l’objet IWTSProtocolConnectionCallback et retourne un pointeur vers celui-ci. Lorsque la connexion n’est plus nécessaire, le protocole doit libérer le pointeur.

Pendant une séquence de connexion, les méthodes suivantes sont appelées par le service Services Bureau à distance dans l’ordre indiqué.

  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 le service Services Bureau à distance doit se reconnecter après avoir appelé SessionArbitrationEnumeration, il se reconnecte en appelant les méthodes suivantes dans l’ordre indiqué :
  1. DisconnectNotify (appelé sur la nouvelle session créée.)
  2. NotifySessionId (appelé sur la session existante.)
  3. GetProtocolHandles
  4. ConnectNotify
  5. LogonNotify
Pour se déconnecter, le service Services Bureau à distance appelle les méthodes suivantes dans l’ordre indiqué :
  1. DisconnectNotify
  2. Close
Le service Services Bureau à distance peut appeler les méthodes suivantes à tout moment après l’établissement d’une connexion :

Héritage

L’interface IWTSProtocolConnection hérite de l’interface IUnknown. IWTSProtocolConnection a également les types de membres suivants :

Méthodes

L’interface IWTSProtocolConnection a ces méthodes.

 
IWTSProtocolConnection ::AcceptConnection

IWTSProtocolConnection ::AcceptConnection n’est plus disponible. Utilisez plutôt IWRdsProtocolConnection ::AcceptConnection.
IWTSProtocolConnection ::AuthenticateClientToSession

IWTSProtocolConnection ::AuthenticateClientToSession n’est plus disponible. Utilisez plutôt IWRdsProtocolConnection ::AuthenticateClientToSession.
IWTSProtocolConnection ::Close

IWTSProtocolConnection ::Close n’est plus disponible. Utilisez plutôt IWRdsProtocolConnection ::Close.
IWTSProtocolConnection ::ConnectNotify

IWTSProtocolConnection ::ConnectNotify n’est plus disponible. Utilisez plutôt IWRdsProtocolConnection ::ConnectNotify.
IWTSProtocolConnection ::CreateVirtualChannel

IWTSProtocolConnection ::CreateVirtualChannel n’est plus disponible. Utilisez plutôt IWRdsProtocolConnection ::CreateVirtualChannel.
IWTSProtocolConnection ::D isconnectNotify

IWTSProtocolConnection ::D isconnectNotify n’est plus disponible. Utilisez plutôt IWRdsProtocolConnection ::D isconnectNotify.
IWTSProtocolConnection ::GetClientData

IWTSProtocolConnection ::GetClientData n’est plus disponible. Utilisez plutôt IWRdsProtocolConnection ::GetClientData.
IWTSProtocolConnection ::GetLastInputTime

IWTSProtocolConnection ::GetLastInputTime n’est plus disponible. Utilisez plutôt IWRdsProtocolConnection ::GetLastInputTime.
IWTSProtocolConnection ::GetLicenseConnection

IWTSProtocolConnection ::GetLicenseConnection n’est plus disponible. Utilisez plutôt IWRdsProtocolConnection ::GetLicenseConnection.
IWTSProtocolConnection ::GetLogonErrorRedirector

IWTSProtocolConnection ::GetLogonErrorRedirector n’est plus disponible. Utilisez plutôt IWRdsProtocolConnection ::GetLogonErrorRedirector.
IWTSProtocolConnection ::GetProtocolHandles

IWTSProtocolConnection ::GetProtocolHandles n’est plus disponible.
IWTSProtocolConnection ::GetProtocolStatus

IWTSProtocolConnection ::GetProtocolStatus n’est plus disponible. Utilisez plutôt IWRdsProtocolConnection ::GetProtocolStatus.
IWTSProtocolConnection ::GetShadowConnection

IWTSProtocolConnection ::GetShadowConnection n’est plus disponible. Utilisez plutôt IWRdsProtocolConnection ::GetShadowConnection.
IWTSProtocolConnection ::GetUserCredentials

IWTSProtocolConnection ::GetUserCredentials n’est plus disponible. Utilisez plutôt IWRdsProtocolConnection ::GetUserCredentials.
IWTSProtocolConnection ::GetUserData

IWTSProtocolConnection ::GetUserData n’est plus disponible. Utilisez plutôt IWRdsProtocolSettings ::MergeSettings.
IWTSProtocolConnection ::IsUserAllowedToLogon

IWTSProtocolConnection ::IsUserAllowedToLogon n’est plus disponible. Utilisez plutôt IWRdsProtocolConnection ::IsUserAllowedToLogon.
IWTSProtocolConnection ::LogonNotify

IWTSProtocolConnection ::LogonNotify n’est plus disponible. Utilisez plutôt IWRdsProtocolConnection ::LogonNotify.
IWTSProtocolConnection ::NotifySessionId

IWTSProtocolConnection ::NotifySessionId n’est plus disponible. Utilisez plutôt IWRdsProtocolConnection ::NotifySessionId.
IWTSProtocolConnection ::QueryProperty

IWTSProtocolConnection ::QueryProperty n’est plus disponible. Utilisez plutôt IWRdsProtocolConnection ::QueryProperty.
IWTSProtocolConnection ::SendBeep

IWTSProtocolConnection ::SendBeep n’est plus disponible.
IWTSProtocolConnection ::SendPolicyData

IWTSProtocolConnection ::SendPolicyData n’est plus disponible. Utilisez plutôt IWRdsProtocolManager ::NotifySettingsChange.
IWTSProtocolConnection ::SessionArbitrationEnumeration

IWTSProtocolConnection ::SessionArbitrationEnumeration n’est plus disponible. Utilisez plutôt IWRdsProtocolConnection ::SessionArbitrationEnumeration.
IWTSProtocolConnection ::SetErrorInfo

IWTSProtocolConnection ::SetErrorInfo n’est plus disponible. Utilisez plutôt IWRdsProtocolConnection ::SetErrorInfo.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2008 R2
Plateforme cible Windows
En-tête wtsprotocol.h