IDebugMessageEvent2

Antarmuka ini digunakan oleh mesin debug (DE) untuk mengirim pesan ke Visual Studio yang memerlukan respons dari pengguna.

Sintaks

IDebugMessageEvent2 : IUnknown

Catatan untuk Pelaksana

DE mengimplementasikan antarmuka ini untuk mengirim pesan ke Visual Studio yang memerlukan respons pengguna. Antarmuka IDebugEvent2 harus diimplementasikan pada objek yang sama dengan antarmuka ini. SDM menggunakan QueryInterface untuk mengakses IDebugEvent2 antarmuka.

Implementasi antarmuka ini harus mengkomunikasikan panggilan SetResponse Visual Studio ke DE. Misalnya, ini dapat dilakukan dengan pesan yang diposting ke utas penanganan pesan DE, atau objek yang menerapkan antarmuka ini dapat menyimpan referensi ke DE dan memanggil kembali ke DE dengan respons yang diteruskan ke IDebugMessageEvent2::SetResponse.

Catatan untuk Penelepon

DE membuat dan mengirim objek kejadian ini untuk menampilkan pesan kepada pengguna yang memerlukan respons. Peristiwa dikirim dengan menggunakan fungsi panggilan balik IDebugEventCallback2 yang disediakan oleh SDM ketika dilampirkan ke program yang sedang di-debug.

Metode dalam Urutan Vtable

Tabel berikut memperlihatkan metode IDebugMessageEvent2.

Metode	Deskripsi
GetMessage	Mendapatkan pesan yang akan ditampilkan.
SetResponse	Mengatur respons, jika ada, dari kotak pesan.

Keterangan

DE akan menggunakan antarmuka ini jika memerlukan respons tertentu dari pengguna untuk pesan tertentu. Misalnya, jika DE mendapatkan pesan "Akses Ditolak" setelah upaya untuk melampirkan ke program dari jarak jauh, DE mengirimkan pesan khusus ini ke Visual Studio dalam IDebugMessageEvent2 peristiwa dengan gaya MB_RETRYCANCELkotak pesan . Ini memungkinkan pengguna untuk mencoba kembali atau membatalkan operasi lampirkan.

DE menentukan bagaimana pesan ini akan ditangani dengan mengikuti konvensi fungsi MessageBox Win32 (lihat AfxMessageBox untuk detailnya).

Gunakan antarmuka IDebugErrorEvent2 untuk mengirim pesan ke Visual Studio yang tidak memerlukan respons dari pengguna.

Persyaratan

Header: msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Rakitan: Microsoft.VisualStudio.Debugger.Interop.dll

Bagikan melalui