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

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

  • Статья

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

Синтаксис

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 (включая Dbgeng.h)