IDebugBreakpoint2::GetCurrentPassCount-Methode (dbgeng.h)
Die GetCurrentPassCount-Methode gibt die verbleibende Anzahl der Male zurück, mit der das Ziel die 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 er ausgelöst wird. Die Anzahl der Male, mit denen das Ziel den Haltepunkt übergeben muss, ohne ihn auszulösen, ist der Wert, der an Anzahl zurückgegeben wird, minus eins.
Rückgabewert
Rückgabecode | BESCHREIBUNG |
---|---|
|
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 fünf Durchläufe gab, gibt GetPassCount 20 und GetCurrentPassCount 15 zurück.
Nachdem das Ziel den Haltepunkt so oft erreicht hat, dass es ausgelöst wird, wird der Haltepunkt bei jedem Treffen ausgelöst, es sei denn, SetPassCount wird erneut aufgerufen. Sie können auch SetPassCount 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 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 Count zurückgegeben werden.
Weitere Informationen zu Haltepunkteigenschaften finden Sie unter Steuern von Breakpointflags und -parametern.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Desktop |
Kopfzeile | dbgeng.h (dbgeng.h einschließen) |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für