Bagikan melalui


IDebugEngine2

Antarmuka ini mewakili mesin debug (DE). Ini digunakan untuk mengelola berbagai aspek sesi penelusuran kesalahan, mulai dari membuat titik henti hingga mengatur dan menghapus pengecualian.

Sintaks

IDebugEngine2 : IUnknown

Catatan untuk Pelaksana

Antarmuka ini diimplementasikan oleh DE kustom untuk mengelola penelusuran kesalahan program. Antarmuka ini harus diimplementasikan oleh DE.

Catatan untuk Penelepon

Antarmuka ini dipanggil oleh manajer debug sesi (SDM) untuk mengelola sesi penelusuran kesalahan, termasuk mengelola pengecualian, membuat titik henti, dan merespons peristiwa sinkron yang dikirim oleh DE.

Metode dalam Urutan Vtable

Tabel berikut memperlihatkan metode IDebugEngine2.

Metode Deskripsi
EnumProgram Membuat enumerator untuk semua program yang di-debug oleh DE.
Pemasangan Melampirkan DE ke program.
CreatePendingBreakpoint Membuat titik henti yang tertunda di DE.
SetException Menentukan bagaimana DE harus menangani pengecualian tertentu.
RemoveSetException Menghapus pengecualian yang ditentukan sehingga tidak lagi ditangani oleh mesin debug.
RemoveAllSetExceptions Menghapus daftar pengecualian yang telah ditetapkan IDE untuk arsitektur atau bahasa run-time tertentu.
GetEngineID Mendapatkan GUID DE.
HancurkanProgram Menginformasikan DE bahwa program yang ditentukan telah dihentikan secara atipikal dan bahwa DE harus membersihkan semua referensi ke program dan mengirim program menghancurkan peristiwa.
LanjutkanDariSinkronousEvent Dipanggil oleh SDM untuk menunjukkan bahwa peristiwa debug sinkron, yang sebelumnya dikirim oleh DE ke SDM, diterima dan diproses.
SetLocale Mengatur lokal DE.
SetRegistryRoot Mengatur akar registri yang saat ini digunakan oleh DE.
SetMetric Mengatur metrik.
CauseBreak Meminta agar semua program di-debug oleh DE ini menghentikan eksekusi saat berikutnya salah satu utas mereka mencoba dijalankan.

Persyaratan

Header: Msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Rakitan: Microsoft.VisualStudio.Debugger.Interop.dll

Baca juga