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

Метод IDebugBreakpoint2::GetPassCount (dbgeng.h)

  • Статья

Метод GetPassCount возвращает количество случаев, когда целевому объекту требовалось достичь расположения точки останова до срабатывания точки останова.

Синтаксис

HRESULT GetPassCount(
  [out] PULONG Count
);

Параметры

[out] Count

Количество случаев, когда целевому объекту изначально требовалось попасть в точку останова, прежде чем она будет активирована. Число случаев, когда целевому объекту требовалось пройти точку останова без ее активации, возвращается значение Count минус единица.

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

Код возврата Описание
S_OK
 Метод выполнен успешно.
 

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

Комментарии

Метод GetPassCount возвращает количество попаданий, которые изначально требовались для активации точки останова. Метод GetCurrentPassCount возвращает количество обращений, которые по-прежнему должны произойти для запуска точки останова. Например, если точка останова была создана с числом проходов 20 и на данный момент было 5 проходов, этот метод GetPassCount возвращает 20, а GetCurrentPassCount возвращает 15.

После того как целевой объект достигнет точки останова достаточно времени для ее активации, точка останова активируется каждый раз при попадании, если только вы не вызовете SetPassCount. Вы также можете вызвать SetPassCount , чтобы изменить количество проходов до активации точки останова. Этот вызов сбрасывает исходное и оставшееся количество проходов.

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

Метод GetParameters также возвращает сведения, возвращаемые в параметре Count.

Дополнительные сведения о свойствах точек останова см. в разделе Управление флагами и параметрами точек останова.

Требования

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