IDebugEventCallbacksWide::Breakpoint-Methode (dbgeng.h)

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

Syntax

HRESULT Breakpoint(
  [in] PDEBUG_BREAKPOINT2 Bp
);

Parameter

[in] Bp

Gibt einen Zeiger auf das IDebugBreakpoint-Objekt an, das 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 nach der Verarbeitung dieses Ereignisses durch das Modul fortgesetzt werden soll. Ausführliche Informationen zur Behandlung dieses Werts durch das Modul finden Sie unter Überwachungsereignisse.

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, und - wenn der Haltepunkt ein privater Haltepunkt ist - dieses IDebugEventCallbacksWide-Objekt wurde beim Client registriert, der den Haltepunkt hinzugefügt hat.

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

Da das Modul das entsprechende IDebugBreakpoint-Objekt löscht, wenn ein Haltepunkt entfernt wird (z. B. mithilfe von RemoveBreakpoint), ist der Wert von Bp möglicherweise ungültig, nachdem Breakpoint zurückgegeben wird. Daher sollten Implementierungen von IDebugEventCallbacksWide 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 (einschließlich Dbgeng.h)