IDebugControl3::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	Softwarehaltepunkt
DEBUG_BREAKPOINT_DATA	Prozessorhaltepunkt

[in] DesiredId

Gibt die gewünschte ID des neuen Haltepunkts an. Wenn es DEBUG_ANY_ID ist, wählt die Engine 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 gibt möglicherweise auch andere Fehlerwerte zurück. 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. Weitere Informationen finden Sie unter 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.