Interface IWRdsProtocolConnection (wtsprotocol.h)

Article
03/06/2024

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 IWRdsProtocolConnection et le transmettre au service Services Bureau à distance en appelant la méthode IWRdsProtocolListenerCallback ::OnConnected . En réponse, le service ajoute une référence à l’objet IWRdsProtocolConnectionCallback 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é.

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é :

DisconnectNotify (appelé sur la nouvelle session créée.)
NotifySessionId (appelé sur la session existante.)
GetInputHandles
GetVideoHandle
ConnectNotify
LogonNotify

Pour se déconnecter, le service Services Bureau à distance appelle les méthodes suivantes dans l’ordre indiqué :

Le service Services Bureau à distance peut appeler les méthodes suivantes à tout moment après l’établissement d’une connexion :

Héritage

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

Méthodes

L’interface IWRdsProtocolConnection utilise ces méthodes.


IWRdsProtocolConnection ::AcceptConnection Indique au protocole de poursuivre la demande de connexion.
IWRdsProtocolConnection ::AuthenticateClientToSession Spécifie une session à laquelle la connexion doit être reconnectée.
IWRdsProtocolConnection ::Close Ferme une connexion après la déconnexion de la session.
IWRdsProtocolConnection ::ConnectNotify Signale au protocole que la session a été initialisée.
IWRdsProtocolConnection ::CreateVirtualChannel Demande que le protocole crée un canal virtuel.
IWRdsProtocolConnection ::D isconnectNotify Avertit le protocole que la session a été déconnectée.
IWRdsProtocolConnection ::GetClientData Demande les paramètres du client à partir du protocole.
IWRdsProtocolConnection ::GetClientMonitorData Récupère le nombre de moniteurs et le numéro de moniteur principal sur le client.
IWRdsProtocolConnection ::GetInputHandles Obtient les handles des périphériques d’entrée/sortie pour le protocole.
IWRdsProtocolConnection ::GetLastInputTime Récupère la dernière fois que le protocole a reçu l’entrée utilisateur.
IWRdsProtocolConnection ::GetLicenseConnection Récupère un objet IWRdsProtocolLicenseConnection utilisé pour commencer le processus de gestion des licences client.
IWRdsProtocolConnection ::GetLogonErrorRedirector Récupère une interface IWRdsProtocolLogonErrorRedirector qui spécifie comment le protocole doit gérer les erreurs d’ouverture de session du client.
IWRdsProtocolConnection ::GetProtocolStatus Récupère des informations sur le protocole status.
IWRdsProtocolConnection ::GetShadowConnection Récupère une référence à l’objet de connexion fantôme à partir du protocole.
IWRdsProtocolConnection ::GetUserCredentials Retourne les informations d’identification de l’utilisateur.
IWRdsProtocolConnection ::GetVideoHandle Obtient le handle de l’appareil vidéo pour le protocole.
IWRdsProtocolConnection ::IsUserAllowedToLogon Détermine à partir du protocole si un utilisateur est autorisé à se connecter à une session.
IWRdsProtocolConnection ::LogonNotify Appelé lorsque l’utilisateur s’est connecté à la session.
IWRdsProtocolConnection ::NotifyCommandProcessCreated Notifie le protocole que le processus Winlogon.exe a été créé et initialisé.
IWRdsProtocolConnection ::NotifySessionId Envoie l’identificateur de la nouvelle session au protocole.
IWRdsProtocolConnection ::P reDisconnect Avertit le protocole que la session est sur le point d’être déconnectée.
IWRdsProtocolConnection ::QueryProperty Récupère une valeur de propriété à partir du protocole.
IWRdsProtocolConnection ::SessionArbitrationEnumeration Appelé après arbitrage pour permettre au protocole de spécifier les sessions à reconnecter.
IWRdsProtocolConnection ::SetErrorInfo Définit les informations d’erreur dans le protocole.

Remarques

Pour éviter un blocage possible lors de l’appel de l’une des méthodes sur cette interface, vous ne devez pas effectuer d’appels de fonction ou de méthode qui entraînent directement ou indirectement l’appel d’une API services Bureau à distance. Si vous devez effectuer un appel sortant, vous devez démarrer un nouveau thread et effectuer l’appel sortant à partir du nouveau thread.

Configuration requise

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

Share via