Método IDebugEventCallbacks::Breakpoint (dbgeng.h)

El motor llama al punto de interrupción método de devolución de llamada cuando el destino emite una excepción de punto de interrupción.

Sintaxis

HRESULT Breakpoint(
  [in] PDEBUG_BREAKPOINT Bp
);

Parámetros

[in] Bp

Especifica un puntero al IDebugBreakpoint objeto correspondiente al punto de interrupción que se desencadenó.

Valor devuelto

Este método devuelve un valor DEBUG_STATUS_XXX, que indica cómo debe continuar la ejecución del destino después de que el motor procese este evento. Para obtener más información sobre cómo el motor trata este valor, consulte Supervisión de eventos.

Observaciones

Si el punto de interrupción tiene un comando asociado, el motor ejecuta ese comando antes de llamar a este método.

El motor solo llamará a este método si existe un IDebugBreakpoint objeto correspondiente al punto de interrupción en el motor y, si el punto de interrupción es un punto de interrupción privado, este objeto IDebugEventCallbacks se registró con el cliente que agregó el punto de interrupción.

El motor llama a este método solo si la marca DEBUG_EVENT_BREAKPOINT está establecida en la máscara devuelta por IDebugEventCallbacks::GetInterestMask.

Dado que el motor elimina el objeto IDebugBreakpoint correspondiente cuando se quita un punto de interrupción (por ejemplo, mediante RemoveBreakpoint), el valor de Bp podría no ser válido después de punto de interrupción devuelve. Por lo tanto, las implementaciones de IDebugEventCallbacks no deben tener acceso a Bp después de punto de interrupción.

Para obtener más información sobre el control de eventos, consulte Supervisión de eventos. Para obtener información sobre cómo administrar puntos de interrupción, vea puntos de interrupción.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	dbgeng.h (include Dbgeng.h)