IDebugControl::AddBreakpoint-Methode (dbgeng.h)

Artikel
02/06/2025

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 eine der folgenden Werte sein:

Wert	Beschreibung
DEBUG_BREAKPOINT_CODE
DEBUG_BREAKPOINT_DATA	des Prozessors

[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 Typ- wurde nicht erkannt.

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

Bemerkungen

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

Haltepunkte werden leer und deaktiviert. Weitere 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 IUnknownerweitert, wird die Lebensdauer des Haltepunkts nicht mithilfe der IUnknown Schnittstelle gesteuert. Stattdessen wird der Haltepunkt gelöscht, nachdem RemoveBreakpoint- aufgerufen wurde.