IDebugEventCallbacks::Breakpoint-Methode (dbgeng.h)

Die Breakpoint-Rückrufmethode wird von der Engine aufgerufen, wenn das Ziel eine Breakpoint-Ausnahme ausgibt.

Syntax

HRESULT Breakpoint(
  [in] PDEBUG_BREAKPOINT Bp
);

Parameter

[in] Bp

Gibt einen Zeiger auf das IDebugBreakpoint-Objekt an, der dem ausgelösten Haltepunkt entspricht.

Rückgabewert

Diese Methode gibt einen DEBUG_STATUS_XXX Wert zurück, der angibt, wie die Ausführung des Ziels fortgesetzt werden soll, nachdem die Engine dieses Ereignis verarbeitet hat. Ausführliche Informationen dazu, wie die Engine diesen Wert behandelt, finden Sie unter Überwachen von Ereignissen.

Hinweise

Wenn der Haltepunkt über einen zugeordneten Befehl verfügt, führt die Engine diesen Befehl aus, bevor diese Methode aufgerufen wird.

Die Engine ruft diese Methode nur auf, wenn ein IDebugBreakpoint-Objekt , das dem Haltepunkt entspricht, in der Engine vorhanden ist. Wenn der Haltepunkt ein privater Haltepunkt ist, wurde dieses IDebugEventCallbacks-Objekt bei dem Client registriert, der den Haltepunkt hinzugefügt hat.

Die Engine ruft diese Methode nur auf, wenn das flag DEBUG_EVENT_BREAKPOINT in der von IDebugEventCallbacks::GetInterestMask zurückgegebenen Maske festgelegt ist.

Da die Engine das entsprechende IDebugBreakpoint-Objekt löscht, wenn ein Haltepunkt entfernt wird (z. B. mithilfe von RemoveBreakpoint), kann der Wert von Bp nach der Rückgabe von Breakpoint ungültig sein. Daher sollten Implementierungen von IDebugEventCallbacks nach der Rückgabe von Breakpoint nicht auf Bp zugreifen.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter Überwachen von Ereignissen. Informationen zum Verwalten von Haltepunkten finden Sie unter Haltepunkte.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (dbgeng.h einschließen)