Freigeben über

IDebugBreakpoint::GetCurrentPassCount-Methode (dbgeng.h)

  • Artikel

Die GetCurrentPassCount--Methode gibt die verbleibende Anzahl der Male zurück, mit denen das Ziel die Haltepunktposition erreichen muss, bevor der Haltepunkt ausgelöst wird.

Syntax

HRESULT GetCurrentPassCount(
  [out] PULONG Count
);

Parameter

[out] Count

Die verbleibende Anzahl der Male, mit denen das Ziel den Haltepunkt erreicht, bevor es ausgelöst wird. Die Häufigkeit, mit der das Ziel den Haltepunkt übergeben mussohne auszulösen, ist der Wert, der an Countminus 1 zurückgegeben wird.

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.

Bemerkungen

Die GetPassCount Methode gibt die Anzahl der Treffer zurück, die ursprünglich zum Auslösen des Haltepunkts erforderlich waren. 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 bisher 5 Durchläufe bestanden haben, gibt GetPassCount 20 zurück und "GetCurrentPassCount" "15" zurück.

Nachdem das Ziel genügend Zeit zum Auslösen des Haltepunkts erreicht hat, wird der Haltepunkt jedes Mal ausgelöst, wenn er erreicht wird, es sei denn, SetPassCount- erneut aufgerufen wird. Sie können auch SetPassCount- aufrufen, um die Passanzahl zu ändern, bevor der Haltepunkt ausgelöst wurde. Dieser Aufruf setzt die ursprüngliche Passanzahl und die verbleibende Passanzahl zurück.

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.

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

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

Anforderungen

Anforderung Wert
Zielplattform- Desktop
Header- dbgeng.h (include Dbgeng.h)