Bagikan melalui


IDebugCanStopEvent2

Antarmuka ini digunakan untuk menanyakan manajer debug sesi (SDM) apakah akan berhenti di lokasi kode saat ini.

Sintaks

IDebugCanStopEvent2 : IUknown

Catatan untuk Pelaksana

Mesin debug (DE) mengimplementasikan antarmuka ini untuk mendukung langkah melalui kode sumber. Antarmuka IDebugEvent2 harus diimplementasikan pada objek yang sama dengan antarmuka ini (SDM menggunakan QueryInterface untuk mengakses IDebugEvent2 antarmuka).

Implementasi antarmuka ini harus mengkomunikasikan panggilan SDM CanStop ke mesin debug. Misalnya, ini dapat dilakukan dengan pesan yang diposting ke utas penanganan pesan mesin debug atau objek yang mengimplementasikan antarmuka ini dapat menyimpan referensi ke mesin debug dan memanggil kembali ke mesin debug dengan bendera diteruskan ke IDebugCanStopEvent2::CanStop.

Catatan untuk Penelepon

DE dapat mengirim metode ini setiap kali DE diminta untuk melanjutkan eksekusi dan DE melangkah melalui kode. Kejadian ini 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 IDebugCanStopEvent2.

Metode Deskripsi
GetReason Mendapatkan alasan untuk peristiwa ini.
CanStop Menentukan apakah program yang di-debug harus berhenti di lokasi kejadian ini (dan mengirim peristiwa yang menjelaskan alasan penghentian) atau hanya melanjutkan eksekusi.
GetDocumentContext Mendapatkan konteks dokumen yang menjelaskan lokasi kejadian ini.
GetCodeContext Mendapatkan konteks kode yang menjelaskan lokasi kejadian ini.

Keterangan

DE mengirimkan antarmuka ini jika pengguna masuk ke fungsi dan DE tidak menemukan informasi debug di sana atau informasi debug ada tetapi DE tidak tahu apakah kode sumber dapat ditampilkan untuk lokasi tersebut.

Persyaratan

Header: msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Rakitan: Microsoft.VisualStudio.Debugger.Interop.dll

Baca juga