IDebugBreakpoint::SetPassCount-Methode (dbgeng.h)

Die SetPassCount--Methode legt fest, wie oft das Ziel die Haltepunktposition erreichen muss, bevor der Haltepunkt ausgelöst wird.

Syntax

HRESULT SetPassCount(
  [in] ULONG Count
);

Parameter

[in] Count

Die Häufigkeit, mit der das Ziel den Haltepunkt erreicht, bevor er ausgelöst wird. Die Häufigkeit, mit der das Ziel den Haltepunkt übergeben muss, ohne ihn auszulösen, ist der Wert Countminus 1.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Bemerkungen

Jedes Mal, wenn die SetPassCount--Methode aufgerufen wird, wird die Anzahl der Male, mit denen das Ziel die Haltepunktposition erreichen muss, bevor der Haltepunkt ausgelöst wird zurückgesetzt.

Nachdem das Ziel den Haltepunkt genug erreicht hat, um den Haltepunkt auszulösen, wird der Haltepunkt jedes Mal ausgelöst, wenn er erreicht wird, es sei denn, SetPassCount erneut aufgerufen wird.

Wenn der Debugger den Code an der Haltepunktposition ausführt, während er den Code durchläuft, trägt diese Ausführung nicht zur Anzahl der Verbleibenden bei, bevor der Haltepunkt ausgelöst wird.

Weitere Informationen zu Haltepunkteigenschaften finden Sie unter Steuern von Haltepunktkennzeichnungen und Parametern.

Anforderungen