Interface IMsTscAxEvents
Inclut des méthodes qui reçoivent des informations du serveur liées aux événements de contrôle client. Les événements incluent la connexion et la déconnexion, les demandes en mode plein écran, l’ouverture de session réussie et les conditions d’erreur.
Membres
L’interface IMsTscAxEvents hérite de l’interface IDispatch. IMsTscAxEvents a également les types de membres suivants :
Méthodes
L’interface IMsTscAxEvents a ces méthodes.
| Méthode | Description |
|---|---|
| OnAuthenticationWarningDismissed | Appelé après qu’un contrôle ActiveX affiche une boîte de dialogue d’authentification (par exemple, la boîte de dialogue d’erreur de certificat). |
| OnAuthenticationWarningDisplayed | Appelé avant qu’un contrôle ActiveX affiche une boîte de dialogue d’authentification (par exemple, la boîte de dialogue d’erreur de certificat). |
| OnAutoReconnected | Appelé lorsque le contrôle client s’est automatiquement reconnecté à une session distante. |
| OnAutoReconnecting | Appelé lorsqu’un client est en cours de reconnexion automatique d’une session avec un serveur hôte de session Bureau à distance. |
| OnAutoReconnecting2 | Appelé lorsqu’un client est en cours de reconnexion automatique d’une session avec un serveur hôte de session Bureau à distance. |
| OnChannelReceivedData | Appelé lorsque le client reçoit des données sur un canal virtuel pouvant faire l’objet d’un script. |
| OnConfirmClose | Appelé lorsque le client appelle la méthode IMsRdpClient::RequestClose . |
| OnConnected | Appelé lorsque le contrôle client est en train d’établir une connexion avec un serveur hôte de session Bureau à distance. |
| OnConnecting | Appelé lorsque le contrôle client commence à se connecter à un serveur en réponse à un appel à IMsTscAx::Connect. |
| OnConnectionBarPullDown | Appelé lorsque l’utilisateur a fait glisser vers le bas dans la barre de connexion. |
| OnDevicesButtonPressed | Appelé lorsque le bouton appareils dans la barre de connexion a été appuyé. |
| OnDisconnected | Appelé lorsque le contrôle client a été déconnecté du serveur hôte de session Bureau à distance. |
| OnEnterFullScreenMode | Appelé lorsque le client passe en mode plein écran. Par exemple, cet événement est appelé lorsque l’utilisateur appuie sur la combinaison de touches de raccourci en mode plein écran (CTRL+ALT+ARRÊT). |
| OnFatalError | Appelé lorsque le contrôle client rencontre une erreur irrécupérable. |
| OnFocusReleased | Appelé lorsque la combinaison de touches de focus de mise en production est enfoncée. Par exemple, cet événement est appelé lorsque l’utilisateur appuie sur la combinaison Ctrl+Alt+Gauche ou Ctrl+Alt+Flèche droite. |
| OnIdleTimeoutNotification | Appelée lorsqu’aucune entrée de souris ou de clavier n’a été effectuée par l’utilisateur pendant la période définie par la méthode IMsRdpClientAdvancedSettings::p ut_MinutesToIdleTimeout . |
| OnLeaveFullScreenMode | Appelé lorsque le client quitte le mode plein écran. Par exemple, cet événement est appelé lorsque l’utilisateur appuie sur la combinaison de touches de raccourci en mode plein écran (CTRL+ALT+ARRÊT). |
| OnLoginComplete | Appelé lorsque le contrôle client s’est correctement connecté à un serveur hôte de session Bureau à distance, après l’affichage de la boîte de dialogue Ouverture de session Windows. |
| OnLogonError | Appelé lorsqu’une erreur d’ouverture de session ou un autre événement d’ouverture de session se produit. |
| OnMouseInputModeChanged | Appelé lorsque le mode d’entrée de la souris a changé. |
| OnNetworkStatusChanged | Appelé lorsque le status réseau a changé. |
| OnReceivedTSPublicKey | Appelé pendant la séquence de connexion lorsque le client récupère la clé publique du serveur. Cet événement est appelé uniquement si la propriété NotifyTSPublicKey est VARIANT_TRUE. |
| OnRemoteDesktopSizeChange | Appelé pour indiquer que la taille du contrôle client sur le Bureau à distance a changé en réponse à une opération de contrôle client. |
| OnRemoteProgramDisplayed | Appelé lorsqu’un programme RemoteApp s’affiche. |
| OnRemoteProgramResult | Appelé lorsqu’un programme RemoteApp retourne un résultat au contrôle client. |
| OnRemoteWindowDisplayed | Appelé lorsqu’une fenêtre RemoteApp s’affiche. |
| OnRequestContainerMinimize | Appelé lorsque l’utilisateur appuie sur le bouton Réduire de la barre de connexion en mode plein écran. Le déclenchement de cet événement est une demande de réduction de l’application conteneur. |
| OnRequestGoFullScreen | Appelée lorsque le client demande à passer en mode plein écran et que la méthode IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen est appelée pour affecter à la propriété ContainerHandledFullScreen une valeur différente de zéro. |
| OnRequestLeaveFullScreen | Appelé lorsque le client demande à quitter le mode plein écran et que la propriété IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen a été définie sur une valeur différente de zéro. |
| OnServiceMessageReceived | Appelé lorsque le client reçoit un message système. |
| OnUserNameAcquired | Appelé lorsque le nom d’utilisateur a été acquis par le contrôle. |
| OnWarning | Appelé lorsque le contrôle client rencontre une condition d’erreur qui n’est pas irrécupérable. |
Remarques
Pour plus d’informations sur la connexion Web Bureau à distance, consultez Configuration requise pour la connexion Web Bureau à distance.
Les objets de contrôle client RDP (MsRdpClient, MsRdpClientNonScriptable et leurs dérivés) sont des objets pouvant être connectés. Pour recevoir des événements du contrôle ActiveX Bureau à distance concernant la session à distance, une application peut implémenter IMstscAxEvents et effectuer les étapes suivantes.
- Appelez IUnknown::QueryInterface sur l’objet de contrôle client RDP pour obtenir un pointeur vers l’interface IConnectionPointContainer .
- Appelez IConnectionPointContainer::FindConnectionPoint, en spécifiant
__uuidof(IMsTscAxEvents)comme paramètre riid , pour obtenir un pointeur vers l’interface IConnectionPoint des événements de contrôle client. - Appelez IConnectionPoint::Conseillez de spécifier la propre implémentation d’IMsTscAxEvents de l’application appelante où les événements doivent être distribués.
L’application peut utiliser les DISPID suivants lors de l’implémentation d’IDispatch::Invoke.
| dispIdMember | Dispatch to, méthode |
|---|---|
| DISPID_CONNECTING = 1 | OnConnecting |
| DISPID_CONNECTED = 2 | OnConnected |
| DISPID_LOGINCOMPLETE = 3 | OnLoginComplete |
| DISPID_DISCONNECTED = 4 | OnDisconnected |
| DISPID_ENTERFULLSCREENMODE = 5 | OnEnterFullScreenMode |
| DISPID_LEAVEFULLSCREENMODE = 6 | OnLeaveFullScreenMode |
| DISPID_CHANNELRECEIVEDDATA = 7 | OnChannelReceivedData |
| DISPID_REQUESTGOFULLSCREEN = 8 | OnRequestGoFullScreen |
| DISPID_REQUESTLEAVEFULLSCREEN = 9 | OnRequestLeaveFullScreen |
| DISPID_FATALERROR = 10 | OnFatalError |
| DISPID_WARNING = 11 | OnWarning |
| DISPID_REMOTEDESKTOPSIZECHANGE = 12 | OnRemoteDesktopSizeChange |
| DISPID_IDLETIMEOUTNOTIFICATION = 13 | OnIdleTimeoutNotification |
| DISPID_REQUESTCONTAINERMINIMIZE = 14 | OnRequestContainerMinimize |
| DISPID_CONFIRMCLOSE = 15 | OnConfirmClose |
| DISPID_RECEIVEDTSPUBLICKEY = 16 | OnReceivedTSPublicKey |
| DISPID_AUTORECONNECTING = 17 | OnAutoReconnecting |
| DISPID_INTERNALDIALOGDISPLAYED = 18 | OnAuthenticationWarningDisplayed |
| DISPID_INTERNALDIALOGDISMISSED = 19 | OnAuthenticationWarningDismissed |
| DISPID_ONREMOTEPROGRAMRESULT = 20 | OnRemoteProgramResult |
| DISPID_ONREMOTEPROGRAMDISPLAYED = 21 | OnRemoteProgramDisplayed |
| DISPID_LOGONERROR = 22 | OnLogonError |
| DISPID_FOCUSRELEASED = 23 | OnFocusReleased |
| DISPID_USERNAMEACQUIRED = 24 | OnUserNameAcquired |
| DISPID_MOUSEINPUTMODECHANGED = 26 | OnMouseInputModeChanged |
| DISPID_ONSTATUSINFO = 27 | Aucun. Fournit un code VT_UI4 status à l’application. L’application peut passer le code status contenu dans « pDispParams-rgvarg>[0].ulVal » à IMsRdpClient7::GetStatusText pour obtenir le texte status associé. |
| DISPID_SERVICEMESSAGERECEIVED = 28 | OnServiceMessageReceived |
| DISPID_ONREMOTEWINDOWDISPLAYED = 29 | OnRemoteWindowDisplayed |
| DISPID_CONNECTIONBARPULLDOWN = 30 | OnConnectionBarPullDown |
| DISPID_ONNETWORKSTATUSCHANGED = 32 | OnNetworkStatusChanged |
| DISPID_AUTORECONNECTED = 33 | OnAutoReconnected |
| DISPID_AUTORECONNECTING2 = 34 | OnAutoReconnecting2 |
| DISPID_CONNECTIONBARDEVICES = 35 | OnDevicesButtonPressed |
| DISPID_HVSINOTIFICATION = 36 | Aucun. Fournit un code d’événement VT_UI4. Cet événement est émis dans Microsoft Defender Protection d'application scénarios. Il ne doit pas être émis pendant les opérations normales. |
| DISPID_ONWOKEUPANDRECONNECTING = 37 | Aucun. Cet événement n’est plus émis par le contrôle ActiveX bureau à distance. |
| DISPID_ONLOCATIONREDIRECTIONENABLEDRECEIVED = 39 | Aucun. Cet événement informe l’application qu’elle peut commencer à utiliser IMsRdpClientNonScriptable6::SendLocation2D ou IMsRdpClientNonScriptable6::SendLocation3D son emplacement sur le serveur afin que l’emplacement géographique du client puisse être reflété dans la session à distance. |
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| Bibliothèque de types |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient est défini comme 791fa017-2de3-492e-acc5-53c67a2b94d0 CLSID_MsRdpClient10 est défini comme C0EFA91A-EEB7-41C7-97FA-F0ED645EFB24 CLSID_MsRdpClient10NotSafeForScripting est défini comme A0C63C30-F08D-4AB4-907C-34905D770C7D CLSID_MsRdpClient2 est défini comme 9059F30F-4EB1-4BD2-9FDC-36F43A218F4A CLSID_MsRdpClient2a est défini comme étant 971127BB-259F-48C2-BD75-5F97A3331551 CLSID_MsRdpClient2NotSafeForScripting est défini comme 3523C2FB-4031-44E4-9A3B-F1E94986EE7F CLSID_MsRdpClient3 est défini comme 7584C670-2274-4EFB-B00B-D6AABA6D3850 CLSID_MsRdpClient3a est défini comme 6A6F4B83-45C5-4CA9-BDD9-0D81C12295E4 CLSID_MsRdpClient3NotSafeForScripting est défini comme ACE575FD-1FCF-4074-9401-EBAB990FA9DE CLSID_MsRdpClient4 est défini comme 4EDCB26C-D24C-4E72-AF07-B576699AC0DE CLSID_MsRdpClient4a est défini comme 54CE37E0-9834-41AE-9896-4DAB69DC022B CLSID_MsRdpClient4NotSafeForScripting est défini comme 6AE29350-321B-42BE-BBE5-12FB5270C0DE CLSID_MsRdpClient5 est défini comme 4EB89FF4-7F78-4A0F-8B8D-2BF02E94E4B2 CLSID_MsRdpClient5NotSafeForScripting est défini comme 4EB2F086-C818-447E-B32C-C51CE2B30D31 CLSID_MsRdpClient6 est défini comme 7390F3D8-0439-4C05-91E3-CF5CB290C3D0 CLSID_MsRdpClient6NotSafeForScripting est défini comme D2EA46A7-C2BF-426B-AF24-E19C44456399 CLSID_MsRdpClient7 est défini comme A9D7038D-B5ED-472E-9C47-94BEA90A5910 CLSID_MsRdpClient7NotSafeForScripting est défini comme 54D38BF7-B1EF-4479-9674-1BD6EA465258 CLSID_MsRdpClient8 est défini comme 5F681803-2900-4C43-A1CC-CF405404A676 CLSID_MsRdpClient8NotSafeForScripting est défini comme A3BC03A0-041D-42E3-AD22-882B7865C9C5 CLSID_MsRdpClient9 est défini comme 301B94BA-5D25-4A12-BFFE-3B6E7A616585 CLSID_MsRdpClient9NotSafeForScripting est défini comme 8B918B82-7985-4C24-89DF-C33AD2BBFBCD CLSID_MsRdpClientNotSafeForScripting est défini comme 7CACBD7B-0D99-468F-AC33-22E495C0AFE5 CLSID_MsTscAx est défini comme 1FB464C8-09BB-4017-A2F5-EB742F04392F CLSID_MsTscAxNotSafeForScripting est défini comme A41A4187-5A86-4E26-B40A-856F9035D9CB |
| IID |
IID_IMsTscAxEvents est défini comme 336d5562-efa8-482e-8cb3-c5c0fc7a7db6 |