Metode IDebugControl::AddBreakpoint (dbgeng.h)

Artikel
08/07/2023

Metode AddBreakpoint membuat titik henti baru untuk target saat ini.

Sintaks

HRESULT AddBreakpoint(
  [in]  ULONG             Type,
  [in]  ULONG             DesiredId,
  [out] PDEBUG_BREAKPOINT *Bp
);

Parameter

[in] Type

Menentukan jenis titik henti titik henti baru. Ini bisa menjadi salah satu nilai berikut:

Nilai	Deskripsi
DEBUG_BREAKPOINT_CODE	titik henti perangkat lunak
DEBUG_BREAKPOINT_DATA	titik henti prosesor

[in] DesiredId

Menentukan ID yang diinginkan dari titik henti baru. Jika DEBUG_ANY_ID, mesin akan memilih ID yang tidak digunakan.

[out] Bp

Menerima penunjuk antarmuka ke titik henti baru.

Nilai kembali

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	Titik henti tidak dapat dibuat dengan ID yang diinginkan atau nilai Jenis tidak dikenali.

Metode ini juga dapat mengembalikan nilai kesalahan lainnya. Lihat Mengembalikan Nilai untuk detail selengkapnya.

Keterangan

Jika DesiredId tidak DEBUG_ANY_ID dan titik henti lain sudah menggunakan ID DesiredId, metode ini akan gagal.

Titik henti dibuat kosong dan dinonaktifkan. Lihat Menggunakan Titik Henti untuk detail tentang mengonfigurasi dan mengaktifkan titik henti.

Klien disimpan sebagai penambal titik henti baru. Lihat GetAdder.

Catatan Meskipun IDebugBreakpoint memperluas antarmuka COM IUnknown, masa pakai breakpoint tidak dikontrol menggunakan antarmuka IUnknown . Sebaliknya, titik henti dihapus setelah RemoveBreakpoint dipanggil.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	dbgeng.h (termasuk Dbgeng.h)

Lihat juga

Menggunakan Titik Henti