IDebugControl2::AddBreakpoint-Methode (dbgeng.h)

Artikel
02/26/2024

Die AddBreakpoint-Methode erstellt einen neuen Haltepunkt für das aktuelle Ziel.

Syntax

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

Parameter

[in] Type

Gibt den Haltepunkttyp des neuen Haltepunkts an. Dies kann einer der folgenden Werte sein:

Wert	BESCHREIBUNG
DEBUG_BREAKPOINT_CODE	Software-Haltepunkt
DEBUG_BREAKPOINT_DATA	Prozessor-Breakpoint

[in] DesiredId

Gibt die gewünschte ID des neuen Haltepunkts an. Wenn es DEBUG_ANY_ID ist, wählt das Modul eine nicht verwendete ID aus.

[out] Bp

Empfängt einen Schnittstellenzeiger auf den neuen Haltepunkt.

Rückgabewert

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_INVALIDARG	Der Haltepunkt konnte nicht mit der gewünschten ID erstellt werden, oder der Wert von Type wurde nicht erkannt.

Diese Methode kann auch andere Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .

Hinweise

Wenn DesiredId nicht DEBUG_ANY_ID ist und ein anderer Haltepunkt bereits die ID DesiredId verwendet, schlagen diese Methoden fehl.

Haltepunkte werden leer erstellt und deaktiviert. Ausführliche Informationen zum Konfigurieren und Aktivieren des Haltepunkts finden Sie unter Verwenden von Haltepunkten .

Der Client wird als Adder des neuen Haltepunkts gespeichert. Siehe GetAdder.

Hinweis Obwohl IDebugBreakpoint die COM-Schnittstelle IUnknown erweitert, wird die Lebensdauer des Haltepunkts nicht mithilfe der IUnknown-Schnittstelle gesteuert. Stattdessen wird der Haltepunkt gelöscht, nachdem RemoveBreakpoint aufgerufen wurde.