Condividi tramite


Metodo IDebugEventCallbacks::Breakpoint (dbgeng.h)

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

Sintassi

HRESULT Breakpoint(
  [in] PDEBUG_BREAKPOINT 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 il modo in cui l'esecuzione della destinazione deve continuare dopo l'elaborazione dell'evento da parte del motore. Per informazioni dettagliate sul modo in cui il motore gestisce 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 nel motore esiste un oggetto IDebugBreakpoint corrispondente al punto di interruzione e, se il punto di interruzione è un punto di interruzione privato, questo oggetto IDebugEventCallbacks è stato registrato con il client che ha aggiunto il punto di interruzione.

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

Poiché il motore elimina l'oggetto IDebugBreakpoint corrispondente quando viene rimosso un punto di interruzione ,ad esempio tramite RemoveBreakpoint, il valore di Bp potrebbe non essere valido dopo la restituzione del punto di interruzione. Di conseguenza, le implementazioni di IDebugEventCallbacks 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

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione dbgeng.h (include Dbgeng.h)