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

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 qui est retournée à Count, moins un.

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 renvoie 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)