Metode IMsRdpClient::RequestClose

Meminta penonaktifan kontrol ActiveX Desktop Jarak Jauh dengan baik. Pematian yang baik dapat mencakup mengakhiri sesi Layanan Desktop Jauh pengguna tetapi tidak mematikan server Host Sesi Desktop Jarak Jauh (Host Sesi RD).

Sintaks

HRESULT RequestClose(
  [out] ControlCloseStatus *pCloseStatus
);

Parameter

pCloseStatus [out]

Nilai dari enumerasi ControlCloseStatus yang menunjukkan apakah aplikasi dapat segera menutup kontrol. Berikut ini adalah daftar nilai yang mungkin.

controlCloseCanProceed (0x0000)

Aplikasi kontainer dapat segera menutup kontrol. Nilai ini juga dapat menunjukkan bahwa koneksi telah dihentikan.

controlCloseWaitForEvents (0x0001)

Aplikasi kontainer tidak boleh segera menutup kontrol; aplikasi harus menunggu salah satu peristiwa yang dijelaskan di bagian Keterangan berikut terjadi sebelum menutup.

Menampilkan nilai

Kembalikan S_OK jika berhasil.

Keterangan

Jika parameter pCloseStatus sama dengan controlCloseWaitForEvents, aplikasi harus menunggu salah satu peristiwa berikut terjadi sebelum aplikasi menutup kontrol:

• IMsTscAxEvents::OnDisconnected. Jika pengguna tidak masuk ke sesi Layanan Desktop Jarak Jauh, aplikasi dapat memanggil fungsi DestroyWindow untuk menghancurkan semua jendela lalu menutup kontrol.
• IMsTscAxEvents::OnConfirmClose. Jika pengguna masuk ke sesi Layanan Desktop Jarak Jauh, kontrol akan mengaktifkan peristiwa OnConfirmClose . Kejadian ini memungkinkan aplikasi untuk meminta pengguna tentang apakah akan menutup koneksi. Jika pengguna membalas ya ke perintah, aplikasi kontainer dapat memanggil DestroyWindow untuk menghancurkan semua jendela, dan menutup kontrol.

RequestClose memungkinkan aplikasi kontainer untuk meminta pengguna tentang apakah akan menutup koneksi. Untuk informasi selengkapnya, lihat IMsTscAxEvents::OnConfirmClose.

Untuk informasi selengkapnya tentang Sambungan Web Desktop Jauh, lihat Persyaratan untuk Koneksi Web Desktop Jarak Jauh.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Pustaka jenis	MsTscAx.dll
DLL	MsTscAx.dll
IID	IID_IMsRdpClient didefinisikan sebagai 92b4a539-7115-4b7c-a5a9-e5d9efc2780a

Lihat juga

IMsRdpClient

IMsRdpClient2

IMsRdpClient3

IMsRdpClient4

IMsRdpClient5

IMsRdpClient6

IMsRdpClient7

IMsRdpClient8

IMsRdpClient9

IMsRdpClient10

IMsTscAxEvents::OnConfirmClose

IMsTscAxEvents::OnDisconnected