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


Метод IDebugControl3::AddBreakpoint (dbgeng.h)

Метод AddBreakpoint создает новую точку останова для текущего целевого объекта.

Синтаксис

HRESULT AddBreakpoint(
  [in]  ULONG             Type,
  [in]  ULONG             DesiredId,
  [out] PDEBUG_BREAKPOINT *Bp
);

Параметры

[in] Type

Указывает тип точки останова новой точки останова. Это может быть одно из следующих значений:

Значение Описание
DEBUG_BREAKPOINT_CODE точка останова программного обеспечения
DEBUG_BREAKPOINT_DATA точка останова процессора

[in] DesiredId

Указывает требуемый идентификатор новой точки останова. Если это DEBUG_ANY_ID, подсистема выберет неиспользуемый идентификатор.

[out] Bp

Получает указатель интерфейса на новую точку останова.

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

Код возврата Описание
S_OK
Метод выполнен успешно.
E_INVALIDARG
Не удалось создать точку останова с требуемым идентификатором или не распознано значение Type .
 

Этот метод также может возвращать другие значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Комментарии

Если DesiredId не DEBUG_ANY_ID а другая точка останова уже использует идентификатор DesiredId, эти методы завершатся ошибкой.

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

Клиент сохраняется как надстройка новой точки останова. См. раздел GetAdder.

Примечание Несмотря на то, что IDebugBreakpoint расширяет интерфейс IUnknown COM-интерфейса, время существования точки останова не контролируется с помощью интерфейса IUnknown . Вместо этого точка останова удаляется после вызова RemoveBreakpoint .
 

Требования

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

См. также раздел

Точки останова

IDebugBreakpoint

IDebugControl

IDebugControl2

IDebugControl3

Удалить точку останова

Использование точек останова