Freigeben über

IDebugBreakpoint::GetCurrentPassCount-Methode (dbgeng.h)

  • Artikel

Die GetCurrentPassCount-Methode gibt die verbleibende Häufigkeit zurück, die das Ziel an der Haltepunktposition erreichen muss, bevor der Haltepunkt ausgelöst wird.

Syntax

HRESULT GetCurrentPassCount(
  [out] PULONG Count
);

Parameter

[out] Count

Die verbleibende Anzahl von Treffern des Ziels auf den Haltepunkt, bevor es ausgelöst wird. Die Anzahl der Male, die das Ziel den Haltepunkt passieren muss, ohne ihn auszulösen, ist der Wert, der an Count zurückgegeben wird, 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

Die GetPassCount-Methode gibt die Anzahl der Treffer zurück, die ursprünglich erforderlich waren, um den Haltepunkt auszulösen. GetCurrentPassCount gibt die Anzahl der Treffer zurück, die noch auftreten müssen, um den Haltepunkt auszulösen. Wenn beispielsweise ein Haltepunkt mit einer Passanzahl von 20 erstellt wurde und es bisher 5 Durchläufe gab, gibt GetPassCount 20 und GetCurrentPassCount 15 zurück.

Nachdem das Ziel den Haltepunkt genug erreicht hat, um ihn auszulösen, wird der Haltepunkt jedes Mal ausgelöst, wenn er erreicht wird, es sei denn , SetPassCount wird erneut aufgerufen. Sie können setPassCount auch aufrufen, um die Anzahl der Durchlaufe zu ändern, bevor der Haltepunkt ausgelöst wurde. Dieser Aufruf setzt die ursprüngliche Passanzahl und die verbleibende Anzahl von Durchgängen zurück.

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.

Die GetParameters-Methode gibt auch die Informationen zurück, die in Count zurückgegeben werden.

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

Anforderungen

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