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

Статья
02/06/2025

Метод 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 расширяет интерфейс COM IUnknown, время существования точки останова не контролируется с помощью интерфейса IUnknown. Вместо этого точка останова удаляется после вызова RemoveBreakpoint.