Metode IMsTscAxEvents::OnAutoReconnecting

Dipanggil ketika klien sedang dalam proses menyambungkan kembali sesi secara otomatis dengan server Host Sesi Desktop Jarak Jauh (Host Sesi RD).

Sintaks

void OnAutoReconnecting(
  [in]  LONG                       disconnectReason,
  [in]  LONG                       attemptCount,
  [out] AutoReconnectContinueState *pArcContinueStatus
);

Parameter

disconnectReason [in]

Kode yang menjelaskan alasan pemutusan sesi terakhir.

attemptCount [in]

Jumlah upaya yang telah dilakukan dalam proses koneksi ulang otomatis saat ini. Jumlah ini meningkat satu per satu untuk setiap upaya yang dilakukan.

pArcContinueStatus [out]

Penunjuk ke kode yang dikembalikan yang menentukan status proses koneksi ulang otomatis. Kode ini dapat diatur ulang untuk mengubah status proses koneksi ulang otomatis saat ini.

Untuk informasi selengkapnya tentang mengatur ulang kode ini, lihat bagian Keterangan.

autoReconnectContinueAutomatic (0)

Proses koneksi ulang terjadi secara otomatis. Ini adalah nilai default.

autoReconnectContinueStop (1)

Proses koneksi ulang telah dihentikan.

autoReconnectContinueManual (2)

Proses koneksi ulang terjadi secara manual.

Mengembalikan nilai

Metode ini tidak mengembalikan nilai.

Keterangan

Terapkan metode ini di sink peristiwa Anda untuk menerima pemberitahuan bahwa kontrol membangun kembali koneksi dengan server Host Sesi RD.

Ketika status proses koneksi ulang otomatis diubah dengan mengatur nilai parameter pArcContinueStatus ke autoReconnectContinueAutomatic, metode ini berfungsi dalam mode penasihat murni. Kontainer dapat mendengarkan peristiwa ini untuk pemberitahuan bahwa proses koneksi ulang otomatis sedang berlangsung. Kontrol akan secara otomatis terus mencoba membuat ulang koneksi berdasarkan waktu internal dan jumlah upayanya sendiri. Metode ini dipanggil selama setiap upaya koneksi ulang otomatis untuk memberi tahu kontainer.

Ketika status proses koneksi ulang otomatis diubah dengan mengatur nilai parameter pArcContinueStatus ke autoReconnectContinueStop, upaya koneksi ulang otomatis saat ini akan dihentikan, pemberitahuan pemutusan sambungan akan dikirim ke kontainer, dan tidak ada pemberitahuan koneksi ulang otomatis lebih lanjut yang akan dikeluarkan.

Catatan

Gunakan properti EnableAutoReconnect untuk mengaktifkan atau menonaktifkan koneksi ulang otomatis.

Ketika status proses koneksi ulang otomatis diubah dengan mengatur nilai parameter pArcContinueStatus ke autoReconnectContinueManual, kontainer akan mengontrol proses koneksi ulang otomatis secara manual dengan memanggil Sambungkan untuk memicu upaya koneksi atau Putuskan sambungan untuk membatalkan proses koneksi ulang otomatis. Setelah diatur ke nilai ini, kontrol akan berhenti melakukan upaya koneksi ulang otomatis dan menjadi kebijakan kontainer untuk melakukan panggilan Connect untuk memicu upaya koneksi ulang otomatis. Ini dilakukan ketika kontainer menyediakan perilaku UI yang disesuaikan untuk koneksi ulang otomatis, seperti memulai ulang koneksi RAS atau VPN yang terputus sebelum proses koneksi ulang otomatis.

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

Lihat juga

IMsTscAxEvents