IDebugEventCallbacksWide::Breakpoint-Methode (dbgeng.h)

Die Breakpoint- Rückrufmethode wird vom Modul aufgerufen, wenn das Ziel einen HaltepunktAusnahmeausgibt.

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 fortgesetzt werden soll, nachdem das Modul dieses Ereignis verarbeitet hat. Ausführliche Informationen zur Behandlung dieses Werts finden Sie unter Monitoring Events.

Bemerkungen

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

Das Modul ruft diese Methode nur auf, wenn ein IDebugBreakpoint--Objekt, das dem Haltepunkt entspricht, im Modul vorhanden ist, und -- wenn der Haltepunkt ein privater Haltepunkt ist - dieses IDebugEventCallbacksWide -Objekt wurde beim Client registriert, der den Haltepunkt hinzugefügt hat.

Das Modul ruft diese Methode nur auf, wenn das DEBUG_EVENT_BREAKPOINT Flag in der Maske festgelegt wird, die von IDebugEventCallbacksWide::GetInterestMaskzurückgegeben wird.

Da das Modul das entsprechende IDebugBreakpoint-Objekt löscht, wenn ein Haltepunkt entfernt wird (z. B. mithilfe RemoveBreakpoint), ist der Wert von Bp nach Rückgabe Haltepunkt möglicherweise ungültig. Daher sollten Implementierungen von IDebugEventCallbacksWide- nicht auf Bp zugreifen, nachdem Haltepunkt zurückgegeben wurde.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Monitoring Events. Informationen zum Verwalten von Haltepunkten finden Sie unter Haltepunkte.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)