Méthode IDebugBreakpoint2 ::GetCurrentPassCount (dbgeng.h)

  • Article

La méthode GetCurrentPassCount retourne le nombre restant de fois où la cible doit atteindre l’emplacement du point d’arrêt avant le déclenchement du point d’arrêt.

Syntaxe

HRESULT GetCurrentPassCount(
  [out] PULONG Count
);

Paramètres

[out] Count

Nombre restant de fois où la cible doit atteindre le point d’arrêt avant de se déclencher. Le nombre de fois où la cible doit passer le point d’arrêt sans le déclencher est la valeur retournée à Count, moins une.

Valeur retournée

Code de retour Description
S_OK
 La méthode a réussi.
 

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour.

Remarques

La méthode GetPassCount retourne le nombre d’accès requis à l’origine pour déclencher le point d’arrêt. GetCurrentPassCount retourne le nombre d’accès qui doivent encore se produire pour déclencher le point d’arrêt. Par exemple, si un point d’arrêt a été créé avec un nombre de passes de 20 et qu’il y a eu 5 passes jusqu’à présent, GetPassCount retourne 20 et GetCurrentPassCount retourne 15.

Une fois que la cible a atteint le point d’arrêt suffisamment de fois pour le déclencher, le point d’arrêt est déclenché chaque fois qu’il est atteint, sauf si SetPassCount est appelé à nouveau. Vous pouvez également appeler SetPassCount pour modifier le nombre de passes avant le déclenchement du point d’arrêt. Cet appel réinitialise le nombre de passes d’origine et le nombre de passes restant.

Si le débogueur exécute le code à l’emplacement du point d’arrêt lors de l’exécution du code, cette exécution ne contribue pas au nombre de fois qu’il reste avant le déclenchement du point d’arrêt.

La méthode GetParameters retourne également les informations retournées dans Count.

Pour plus d’informations sur les propriétés du point d’arrêt, consultez Contrôle des indicateurs et des paramètres de point d’arrêt.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête dbgeng.h (inclure Dbgeng.h)