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

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

  • Статья

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

Синтаксис

HRESULT Breakpoint(
  [in] PDEBUG_BREAKPOINT2 Bp
);

Параметры

[in] Bp

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

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

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

Комментарии

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

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

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

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

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

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h)