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

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

  • Статья

Метод GetCurrentPassCount возвращает оставшееся количество раз, когда целевой объект должен достичь расположения точки останова перед активацией точки останова.

Синтаксис

HRESULT GetCurrentPassCount(
  [out] PULONG Count
);

Параметры

[out] Count

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

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

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

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

Комментарии

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

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

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

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

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

Требования

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