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

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

Синтаксис

HRESULT GetCurrentPassCount(
  [out] PULONG Count
);

Параметры

[out] Count

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

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

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

Замечания

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

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

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

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

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

Требования