Метод IDebugEventCallbacks::Breakpoint (dbgeng.h)

Статья
02/06/2025

Метод обратного вызова точки останова вызывается подсистемой, когда целевой объект выдает исключение точки останова.

Синтаксис

HRESULT Breakpoint(
  [in] PDEBUG_BREAKPOINT Bp
);

Параметры

[in] Bp

Указывает указатель на объект IDebugBreakpoint, соответствующий точке останова, которая была активирована.

Возвращаемое значение

Этот метод возвращает значение DEBUG_STATUS_XXX, указывающее, как выполнение целевого объекта должно происходить после обработки этого события подсистемой. Дополнительные сведения о том, как подсистема обрабатывает это значение, см. в событий мониторинга.

Замечания

Если точка останова имеет связанную команду, подсистема выполняет эту команду перед вызовом этого метода.

Подсистема вызывает этот метод только в том случае, если объект IDebugBreakpoint, соответствующий точке останова, существует в обработчике, и если точка останова является частной точкой останова, это IDebugEventCallbacks объект был зарегистрирован в клиенте, который добавил точку останова.

Модуль вызывает этот метод, только если флаг DEBUG_EVENT_BREAKPOINT задан в маске, возвращенной IDebugEventCallbacks::GetInterestMask.

Так как модуль удаляет соответствующий объект IDebugBreakpoint при удалении точки останова (например, с помощью RemoveBreakpoint), значение Bp может быть недопустимым после точки останова. Поэтому реализации IDebugEventCallbacks не должны получать доступ к bp после возврата точки останова.

Дополнительные сведения об обработке событий см. в событий мониторинга. Сведения об управлении точками останова см. в точках останова.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	dbgeng.h (include Dbgeng.h)

Поделиться через