Interfaccia IMsTscAxEvents
Include metodi che ricevono informazioni dal server correlate agli eventi di controllo client. Gli eventi includono la connessione e la disconnessione, le richieste in modalità schermo intero, l'accesso riuscito e le condizioni di errore.
Membri
L'interfaccia IMsTscAxEvents eredita dall'interfaccia IDispatch . IMsTscAxEvents include anche questi tipi di membri:
Metodi
L'interfaccia IMsTscAxEvents include questi metodi.
| Metodo | Descrizione |
|---|---|
| OnAuthenticationWarningDismissed | Chiamato dopo che un controllo ActiveX visualizza una finestra di dialogo di autenticazione, ad esempio la finestra di dialogo di errore del certificato. |
| OnAuthenticationWarningDisplayed | Chiamato prima che un controllo ActiveX visualizzi una finestra di dialogo di autenticazione, ad esempio la finestra di dialogo di errore del certificato. |
| OnAutoReconnected | Chiamato quando il controllo client si riconnette automaticamente a una sessione remota. |
| OnAutoReconnecting | Chiamato quando un client è in corso di riconnessione automatica di una sessione con un server host sessione Desktop remoto. |
| OnAutoReconnecting2 | Chiamato quando un client è in corso di riconnessione automatica di una sessione con un server host sessione Desktop remoto. |
| OnChannelReceivedData | Chiamato quando il client riceve i dati in un canale virtuale scriptabile. |
| OnConfirmClose | Chiamato quando il client chiama il metodo IMsRdpClient::RequestClose . |
| OnConnected | Chiamato quando il controllo client è in corso di stabilire una connessione con un server Host sessione Desktop remoto. |
| OnConnecting | Chiamato quando il controllo client inizia a connettersi a un server in risposta a una chiamata a IMsTscAx::Connect. |
| OnConnectionBarPullDown | Chiamato quando l'utente ha trascinato verso il basso sulla barra di connessione. |
| OnDevicesButtonPressed | Chiamato quando è stato premuto il pulsante dispositivi nella barra di connessione. |
| OnDisconnected | Chiamato quando il controllo client è stato disconnesso dal server Host sessione Desktop remoto. |
| OnEnterFullScreenMode | Chiamato quando il client entra in modalità schermo intero. Ad esempio, questo evento viene chiamato quando l'utente preme la combinazione di tasti di scelta rapida in modalità schermo intero (CTRL+ALT+INTERR). |
| OnFatalError | Chiamato quando il controllo client rileva un errore irreversibile. |
| OnFocusReleased | Viene chiamato quando viene premuta la combinazione di tasti di attivazione del rilascio. Ad esempio, questo evento viene chiamato quando l'utente preme CTRL+ALT+FRECCIA SINISTRA o la combinazione di tasti CTRL+ALT+FRECCIA DESTRA. |
| OnIdleTimeoutNotification | Chiamato quando l'utente non ha immesso il mouse o la tastiera durante il periodo di tempo impostato dal metodo IMsRdpClientAdvancedSettings::p ut_MinutesToIdleTimeout . |
| OnLeaveFullScreenMode | Chiamato quando il client lascia la modalità schermo intero. Ad esempio, questo evento viene chiamato quando l'utente preme la combinazione di tasti di scelta rapida in modalità schermo intero (CTRL+ALT+INTERR). |
| OnLoginComplete | Chiamato quando il controllo client ha eseguito correttamente l'accesso a un server Host sessione Desktop remoto, dopo la visualizzazione della finestra di dialogo Accesso a Windows. |
| OnLogonError | Chiamato quando si verifica un errore di accesso o un altro evento di accesso. |
| OnMouseInputModeChanged | Chiamato quando la modalità di input del mouse è cambiata. |
| OnNetworkStatusChanged | Viene chiamato quando lo stato della rete è cambiato. |
| OnReceivedTSPublicKey | Chiamato durante la sequenza di connessione quando il client recupera la chiave pubblica dal server. Questo evento viene chiamato solo se la proprietà NotifyTSPublicKey è VARIANT_TRUE. |
| OnRemoteDesktopSizeChange | Chiamato per indicare che le dimensioni del controllo client sul desktop remoto sono cambiate in risposta a un'operazione di controllo client. |
| OnRemoteProgramDisplayed | Chiamato quando viene visualizzato un programma RemoteApp. |
| OnRemoteProgramResult | Chiamato quando un programma RemoteApp restituisce un risultato al controllo client. |
| OnRemoteWindowDisplayed | Viene chiamato quando viene visualizzata una finestra RemoteApp. |
| OnRequestContainerMinimize | Chiamato quando l'utente preme il pulsante Riduci a icona sulla barra di connessione in modalità schermo intero. La generazione di questo evento è una richiesta che l'applicazione contenitore riduce al minimo. |
| OnRequestGoFullScreen | Chiamato quando il client richiede di passare alla modalità a schermo intero e il metodo IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen viene chiamato per impostare la proprietà ContainerHandledFullScreen su un valore diverso da zero. |
| OnRequestLeaveFullScreen | Chiamato quando il client richiede di lasciare la modalità a schermo intero e la proprietà IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen è stata impostata su un valore diverso da zero. |
| OnServiceMessageReceived | Chiamato quando il client riceve un messaggio di sistema. |
| OnUserNameAcquired | Chiamato quando il nome utente è stato acquisito dal controllo . |
| OnWarning | Chiamato quando il controllo client rileva una condizione di errore che non è irreversibile. |
Commenti
Per altre informazioni sulla connessione Web Desktop remoto, vedere Requisiti per connessione Web Desktop remoto.
Gli oggetti di controllo client RDP (MsRdpClient, MsRdpClientNonScriptable e i relativi derivati) sono oggetti connettibili. Per ricevere eventi dal controllo ActiveX desktop remoto sulla sessione remota, un'applicazione può implementare IMstscAxEvents e seguire questa procedura.
- Chiamare IUnknown::QueryInterface nell'oggetto controllo client RDP per ottenere un puntatore all'interfaccia IConnectionPointContainer .
- Chiamare IConnectionPointContainer::FindConnectionPoint, specificando
__uuidof(IMsTscAxEvents)come parametro riid , per ottenere un puntatore all'interfaccia IConnectionPoint degli eventi di controllo client. - Chiamare IConnectionPoint::Consiglia di specificare la propria implementazione dell'applicazione chiamante di IMsTscAxEvents in cui devono essere inviati gli eventi.
L'applicazione può usare i diSPID seguenti durante l'implementazione di IDispatch::Invoke.
| dispIdMember | Invio al metodo |
|---|---|
| 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 | Nessuno. Fornisce un codice di stato VT_UI4 all'applicazione. L'applicazione può passare il codice di stato contenuto in 'pDispParams-rgvarg>[0].ulVal'' a IMsRdpClient7::GetStatusText per ottenere il testo di stato associato. |
| 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 | Nessuno. Fornisce un codice evento VT_UI4. Questo evento viene generato negli scenari di Microsoft Defender Application Guard. Non deve essere generato durante le normali operazioni. |
| DISPID_ONWOKEUPANDRECONNECTING = 37 | Nessuno. Questo evento non viene più generato dal controllo ActiveX desktop remoto. |
| DISPID_ONLOCATIONREDIRECTIONENABLEDRECEIVED = 39 | Nessuno. Questo evento notifica all'applicazione che può iniziare a usare IMsRdpClientNonScriptable6::SendLocation2D o IMsRdpClientNonScriptable6::SendLocation3D la relativa posizione nel server in modo che la posizione geografica del client possa essere riflessa nella sessione remota. |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Libreria dei tipi |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient è definito come 791fa017-2de3-492e-acc5-53c67a2b94d0 CLSID_MsRdpClient10 è definito come C0EFA91A-EEB7-41C7-97FA-F0ED645EFB24 CLSID_MsRdpClient10NotSafeForScripting è definito come A0C63C30-F08D-4AB4-907C-34905D770C7D CLSID_MsRdpClient2 è definito come 9059F30F-4EB1-4BD2-9FDC-36F43A218F4A CLSID_MsRdpClient2a è definito come 971127BB-259F-48C2-BD75-5F97A33331551 CLSID_MsRdpClient2NotSafeForScripting è definito come 3523C2FB-4031-44E4-9A3B-F1E94986EE7F CLSID_MsRdpClient3 è definito come 7584C670-2274-4EFB-B00B-D6AABA6D3850 CLSID_MsRdpClient3a è definito come 6A6F4B83-45C5-4CA9-BDD9-0D81C12295E4 CLSID_MsRdpClient3NotSafeForScripting è definito come ACE575FD-1FCF-4074-9401-EBAB990FA9DE CLSID_MsRdpClient4 è definito come 4EDCB26C-D24C-4E72-AF07-B576699AC0DE CLSID_MsRdpClient4a è definito come 54CE37E0-9834-41AE-9896-4DAB69DC022B CLSID_MsRdpClient4NotSafeForScripting è definito come 6AE29350-321B-42BE-BBE5-12FB5270C0DE CLSID_MsRdpClient5 è definito come 4EB89FF4-7F78-4A0F-8B8D-2BF02E94E4B2 CLSID_MsRdpClient5NotSafeForScripting è definito come 4EB2F086-C818-447E-B32C-C51CE2B30D31 CLSID_MsRdpClient6 è definito come 7390F3D8-0439-4C05-91E3-CF5CB290C3D0 CLSID_MsRdpClient6NotSafeForScripting è definito come D2EA46A7-C2BF-426B-AF24-E19C44456399 CLSID_MsRdpClient7 viene definito come A9D7038D-B5ED-472E-9C47-94BEA90A5910 CLSID_MsRdpClient7NotSafeForScripting viene definito come 54D38BF7-B1EF-4479-9674-1BD6EA465258 CLSID_MsRdpClient8 è definito come 5F681803-2900-4C43-A1CC-CF405404A676 CLSID_MsRdpClient8NotSafeForScripting viene definito come A3BC03A0-041D-42E3-AD22-882B7865C9C5 CLSID_MsRdpClient9 è definito come 301B94BA-5D25-4A12-BFFE-3B6E7A616585 CLSID_MsRdpClient9NotSafeForScripting è definito come 8B918B82-7985-4C24-89DF-C33AD2BBFBCD CLSID_MsRdpClientNotSafeForScripting è definito come 7CACBD7B-0D99-468F-AC33-22E495C0AFE5 CLSID_MsTscAx è definito come 1FB464C8-09BB-4017-A2F5-EB742F04392F CLSID_MsTscAxNotSafeForScripting viene definito come A41A4187-5A86-4E26-B40A-856F9035D9CB |
| IID |
IID_IMsTscAxEvents viene definito come 336d5562-efa8-482e-8cb3-c5c0fc7a7db6 |