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

  • Article

La méthode GetPassCount retourne le nombre de fois où la cible a été initialement requise pour atteindre l’emplacement du point d’arrêt avant le déclenchement du point d’arrêt.

Syntaxe

HRESULT GetPassCount(
  [out] PULONG Count
);

Paramètres

[out] Count

Nombre de fois où la cible a été initialement requise pour atteindre le point d’arrêt avant son déclenchement. Le nombre de fois où la cible a été initialement requise pour 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. La méthode 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, cette méthode GetPassCount retourne 20 et GetCurrentPassCount renvoie 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 vous appelez SetPassCount. 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)