IDebugBreakpoint2::SetPassCount-Methode (dbgeng.h)

  • Artikel

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 erreichen muss, bevor es ausgelöst wird. Die Anzahl der Male, wie das Ziel den Haltepunkt passieren muss, ohne ihn auszulösen, ist der Wert von Count, minus 1.

Rückgabewert

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode war erfolgreich.
 

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

Hinweise

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

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

Wenn der Debugger den Code beim Durchlaufen des Codes an der Haltepunktposition ausführt, trägt diese Ausführung nicht zur Anzahl der verbleibenden Zeiten bei, bis der Haltepunkt ausgelöst wird.

Weitere Informationen zu Breakpointeigenschaften finden Sie unter Steuern von Breakpointflags und -parametern.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile dbgeng.h (einschließlich Dbgeng.h)