Antarmuka IMsTscAxEvents
Termasuk metode yang menerima informasi dari server yang terkait dengan peristiwa kontrol klien. Peristiwa termasuk menyambungkan dan memutuskan sambungan, permintaan mode layar penuh, masuk yang berhasil, dan kondisi kesalahan.
Anggota
Antarmuka IMsTscAxEvents mewarisi dari antarmuka IDispatch . IMsTscAxEvents juga memiliki jenis anggota ini:
Metode
Antarmuka IMsTscAxEvents memiliki metode ini.
| Metode | Deskripsi |
|---|---|
| OnAuthenticationWarningDismissed | Dipanggil setelah kontrol ActiveX menampilkan kotak dialog autentikasi (misalnya, kotak dialog kesalahan sertifikat). |
| OnAuthenticationWarningDisplayed | Dipanggil sebelum kontrol ActiveX menampilkan kotak dialog autentikasi (misalnya, kotak dialog kesalahan sertifikat). |
| OnAutoReconnected | Dipanggil ketika kontrol klien telah secara otomatis terhubung kembali ke sesi jarak jauh. |
| OnAutoReconnecting | Dipanggil ketika klien sedang dalam proses menyambungkan kembali sesi secara otomatis dengan server Host Sesi RD. |
| OnAutoReconnecting2 | Dipanggil ketika klien sedang dalam proses menyambungkan kembali sesi secara otomatis dengan server Host Sesi RD. |
| OnChannelReceivedData | Dipanggil ketika klien menerima data di saluran virtual yang dapat ditulis. |
| OnConfirmClose | Dipanggil saat klien memanggil metode IMsRdpClient::RequestClose . |
| Terkoneksi | Dipanggil ketika kontrol klien sedang dalam proses membuat koneksi dengan server Host Sesi RD. |
| Sedang Menyambungkan | Dipanggil ketika kontrol klien mulai menyambungkan ke server sebagai respons terhadap panggilan ke IMsTscAx::Connect. |
| OnConnectionBarPullDown | Dipanggil saat pengguna telah menyeret ke bawah pada bilah koneksi. |
| OnDevicesButtonPressed | Dipanggil ketika tombol perangkat di bilah koneksi telah ditekan. |
| OnDisconnected | Dipanggil ketika kontrol klien telah terputus dari server Host Sesi RD. |
| OnEnterFullScreenMode | Dipanggil saat klien memasuki mode layar penuh. Misalnya, peristiwa ini dipanggil ketika pengguna menekan kombinasi tombol pintasan mode layar penuh (CTRL+ALT+BREAK). |
| OnFatalError | Dipanggil ketika kontrol klien mengalami kesalahan fatal. |
| OnFocusReleased | Dipanggil saat kombinasi tombol fokus rilis ditekan. Misalnya, peristiwa ini dipanggil ketika pengguna menekan tombol CTRL+ALT+LEFT ARROW atau tombol CTRL+ALT+RIGHT ARROW. |
| OnIdleTimeoutNotification | Dipanggil ketika belum ada input mouse atau keyboard oleh pengguna selama periode waktu yang ditetapkan oleh metode IMsRdpClientAdvancedSettings::p ut_MinutesToIdleTimeout . |
| OnLeaveFullScreenMode | Dipanggil ketika klien meninggalkan mode layar penuh. Misalnya, peristiwa ini dipanggil ketika pengguna menekan kombinasi tombol pintasan mode layar penuh (CTRL+ALT+BREAK). |
| OnLoginComplete | Dipanggil ketika kontrol klien berhasil masuk ke server Host Sesi RD, mengikuti tampilan kotak dialog Masuk Windows. |
| OnLogonError | Dipanggil saat terjadi kesalahan masuk atau peristiwa masuk lainnya. |
| OnMouseInputModeChanged | Dipanggil ketika mode input mouse telah berubah. |
| OnNetworkStatusChanged | Dipanggil ketika status jaringan telah berubah. |
| OnReceivedTSPublicKey | Dipanggil selama urutan koneksi ketika klien mengambil kunci publik dari server. Kejadian ini hanya dipanggil jika properti NotifyTSPublicKeyVARIANT_TRUE. |
| OnRemoteDesktopSizeChange | Dipanggil untuk menunjukkan bahwa ukuran kontrol klien pada desktop jarak jauh telah berubah sebagai respons terhadap operasi kontrol klien. |
| OnRemoteProgramDisplayed | Dipanggil ketika program RemoteApp ditampilkan. |
| OnRemoteProgramResult | Dipanggil ketika program RemoteApp mengembalikan hasil ke kontrol klien. |
| OnRemoteWindowDisplayed | Dipanggil saat jendela RemoteApp ditampilkan. |
| OnRequestContainerMinimize | Dipanggil saat pengguna menekan tombol Minimalkan pada bilah koneksi dalam mode layar penuh. Pengaktifan peristiwa ini adalah permintaan yang diminimalkan aplikasi kontainer itu sendiri. |
| OnRequestGoFullScreen | Dipanggil ketika klien meminta untuk beralih ke mode layar penuh dan metode IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen dipanggil untuk mengatur properti ContainerHandledFullScreen ke nilai bukan nol. |
| OnRequestLeaveFullScreen | Dipanggil ketika klien meminta untuk meninggalkan mode layar penuh dan properti IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen telah diatur ke nilai bukan nol. |
| OnServiceMessageReceived | Dipanggil ketika klien menerima pesan sistem. |
| OnUserNameAcquired | Dipanggil ketika nama pengguna telah diperoleh oleh kontrol. |
| OnWarning | Dipanggil ketika kontrol klien mengalami kondisi kesalahan yang tidak fatal. |
Keterangan
Untuk informasi selengkapnya tentang Sambungan Web Desktop Jauh, lihat Persyaratan untuk Koneksi Web Desktop Jarak Jauh.
Objek kontrol klien RDP (MsRdpClient, MsRdpClientNonScriptable dan turunannya) adalah objek yang dapat dihubungkan. Untuk menerima peristiwa dari kontrol ActiveX Desktop Jarak Jauh tentang sesi jarak jauh, aplikasi dapat menerapkan IMstscAxEvents dan melakukan langkah-langkah berikut.
- Panggil IUnknown::QueryInterface pada objek kontrol klien RDP untuk mendapatkan penunjuk ke antarmuka IConnectionPointContainer .
- Panggil IConnectionPointContainer::FindConnectionPoint, yang menentukan
__uuidof(IMsTscAxEvents)sebagai parameter riid , untuk mendapatkan penunjuk ke antarmuka IConnectionPoint dari peristiwa kontrol klien. - Panggil IConnectionPoint::Advise untuk menentukan implementasi IMsTscAxEvents aplikasi panggilan sendiri tempat peristiwa akan dikirim.
Aplikasi dapat menggunakan DISPID berikut saat menerapkan IDispatch::Invoke.
| dispIdMember | Mengirimkan ke metode |
|---|---|
| DISPID_CONNECTING = 1 | Sedang Menyambungkan |
| DISPID_CONNECTED = 2 | Terkoneksi |
| 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 | Tidak ada. Menyediakan kode status VT_UI4 ke aplikasi. Aplikasi dapat meneruskan kode status yang terkandung dalam 'pDispParams-rgvarg>[0].ulVal'' ke IMsRdpClient7::GetStatusText untuk mendapatkan teks status terkait. |
| 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 | Tidak ada. Menyediakan kode peristiwa VT_UI4. Kejadian ini dipancarkan dalam skenario Microsoft Defender Application Guard. Ini tidak boleh dipancarkan selama operasi normal. |
| DISPID_ONWOKEUPANDRECONNECTING = 37 | Tidak ada. Kejadian ini tidak lagi dipancarkan oleh kontrol ActiveX Desktop Jarak Jauh. |
| DISPID_ONLOCATIONREDIRECTIONENABLEDRECEIVED = 39 | Tidak ada. Kejadian ini memberi tahu aplikasi bahwa aplikasi dapat mulai menggunakan IMsRdpClientNonScriptable6::SendLocation2D atau IMsRdpClientNonScriptable6::SendLocation3D lokasinya ke server sehingga lokasi geografis klien dapat tercermin dalam sesi jarak jauh. |
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows Vista |
| Server minimum yang didukung |
Windows Server 2008 |
| Pustaka jenis |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient didefinisikan sebagai 791fa017-2de3-492e-acc5-53c67a2b94d0 CLSID_MsRdpClient10 didefinisikan sebagai C0EFA91A-EEB7-41C7-97FA-F0ED645EFB24 CLSID_MsRdpClient10NotSafeForScripting didefinisikan sebagai A0C63C30-F08D-4AB4-907C-34905D770C7D CLSID_MsRdpClient2 didefinisikan sebagai 9059F30F-4EB1-4BD2-9FDC-36F43A218F4A CLSID_MsRdpClient2a didefinisikan sebagai 971127BB-259F-48C2-BD75-5F97A3331551 CLSID_MsRdpClient2NotSafeForScripting didefinisikan sebagai 3523C2FB-4031-44E4-9A3B-F1E94986EE7F CLSID_MsRdpClient3 didefinisikan sebagai 7584C670-2274-4EFB-B00B-D6AABA6D3850 CLSID_MsRdpClient3a didefinisikan sebagai 6A6F4B83-45C5-4CA9-BDD9-0D81C12295E4 CLSID_MsRdpClient3NotSafeForScripting didefinisikan sebagai ACE575FD-1FCF-4074-9401-EBAB990FA9DE CLSID_MsRdpClient4 didefinisikan sebagai 4EDCB26C-D24C-4E72-AF07-B576699AC0DE CLSID_MsRdpClient4a didefinisikan sebagai 54CE37E0-9834-41AE-9896-4DAB69DC022B CLSID_MsRdpClient4NotSafeForScripting didefinisikan sebagai 6AE29350-321B-42BE-BBE5-12FB5270C0DE CLSID_MsRdpClient5 didefinisikan sebagai 4EB89FF4-7F78-4A0F-8B8D-2BF02E94E4B2 CLSID_MsRdpClient5NotSafeForScripting didefinisikan sebagai 4EB2F086-C818-447E-B32C-C51CE2B30D31 CLSID_MsRdpClient6 didefinisikan sebagai 7390F3D8-0439-4C05-91E3-CF5CB290C3D0 CLSID_MsRdpClient6NotSafeForScripting didefinisikan sebagai D2EA46A7-C2BF-426B-AF24-E19C44456399 CLSID_MsRdpClient7 didefinisikan sebagai A9D7038D-B5ED-472E-9C47-94BEA90A5910 CLSID_MsRdpClient7NotSafeForScripting didefinisikan sebagai 54D38BF7-B1EF-4479-9674-1BD6EA465258 CLSID_MsRdpClient8 didefinisikan sebagai 5F681803-2900-4C43-A1CC-CF405404A676 CLSID_MsRdpClient8NotSafeForScripting didefinisikan sebagai A3BC03A0-041D-42E3-AD22-882B7865C9C5 CLSID_MsRdpClient9 didefinisikan sebagai 301B94BA-5D25-4A12-BFFE-3B6E7A616585 CLSID_MsRdpClient9NotSafeForScripting didefinisikan sebagai 8B918B82-7985-4C24-89DF-C33AD2BBFBCD CLSID_MsRdpClientNotSafeForScripting didefinisikan sebagai 7CACBD7B-0D99-468F-AC33-22E495C0AFE5 CLSID_MsTscAx didefinisikan sebagai 1FB464C8-09BB-4017-A2F5-EB742F04392F CLSID_MsTscAxNotSafeForScripting didefinisikan sebagai A41A4187-5A86-4E26-B40A-856F9035D9CB |
| IID |
IID_IMsTscAxEvents didefinisikan sebagai 336d5562-efa8-482e-8cb3-c5c0fc7a7db6 |
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk