Metodo IDebugEventCallbacksWide::Breakpoint (dbgeng.h)

Il metodo callback del punto di interruzione viene chiamato dal motore quando la destinazione generaun'eccezione del punto di interruzione.

Sintassi

HRESULT Breakpoint(
  [in] PDEBUG_BREAKPOINT2 Bp
);

Parametri

[in] Bp

Specifica un puntatore all'oggetto IDebugBreakpoint corrispondente al punto di interruzione attivato.

Valore restituito

Questo metodo restituisce un valore DEBUG_STATUS_XXX , che indica come l'esecuzione della destinazione deve procedere dopo che il motore elabora questo evento. Per informazioni dettagliate sul modo in cui il motore tratta questo valore, vedere Monitoraggio degli eventi.

Commenti

Se il punto di interruzione ha un comando associato, il motore esegue tale comando prima di chiamare questo metodo.

Il motore chiamerà questo metodo solo se un oggetto IDebugBreakpoint corrispondente al punto di interruzione esiste nel motore e, se il punto di interruzione è un punto di interruzione privato, questo oggetto IDebugEventCallbacksWide è stato registrato con il client che ha aggiunto il punto di interruzione.

Il motore chiama questo metodo solo se il flag di DEBUG_EVENT_BREAKPOINT è impostato nella maschera restituita da IDebugEventCallbacksWide::GetInterestMask.

Poiché il motore elimina l'oggetto IDebugBreakpoint corrispondente quando viene rimosso un punto di interruzione ,ad esempio usando RemoveBreakpoint, il valore di Bp potrebbe non essere valido dopo che il punto di interruzione restituisce. Pertanto, le implementazioni di IDebugEventCallbacksWide non devono accedere a Bp dopo la restituzione del punto di interruzione .

Per altre informazioni sulla gestione degli eventi, vedere Monitoraggio degli eventi. Per informazioni sulla gestione dei punti di interruzione, vedere Punti di interruzione.

Requisiti