Méthode IDebugEventCallbacks ::Breakpoint (dbgeng.h)

La méthode de rappel point d’arrêt est appelée par le moteur lorsque la cible émet une exception de point d’arrêt.

Syntaxe

HRESULT Breakpoint(
  [in] PDEBUG_BREAKPOINT Bp
);

Paramètres

[in] Bp

Spécifie un pointeur vers l’objet IDebugBreakpoint correspondant au point d’arrêt qui a été déclenché.

Valeur retournée

Cette méthode retourne une valeur DEBUG_STATUS_XXX , qui indique comment l’exécution de la cible doit se poursuivre une fois que le moteur a traité cet événement. Pour plus d’informations sur la façon dont le moteur traite cette valeur, consultez Surveillance des événements.

Remarques

Si le point d’arrêt a une commande associée, le moteur exécute cette commande avant d’appeler cette méthode.

Le moteur n’appelle cette méthode que si un objet IDebugBreakpoint correspondant au point d’arrêt existe dans le moteur, et si le point d’arrêt est un point d’arrêt privé, cet objet IDebugEventCallbacks a été inscrit auprès du client qui a ajouté le point d’arrêt.

Le moteur appelle cette méthode uniquement si l’indicateur DEBUG_EVENT_BREAKPOINT est défini dans le masque retourné par IDebugEventCallbacks ::GetInterestMask.

Étant donné que le moteur supprime l’objet IDebugBreakpoint correspondant lorsqu’un point d’arrêt est supprimé (par exemple, à l’aide de RemoveBreakpoint), la valeur de Bp peut être non valide après le retour du point d’arrêt . Par conséquent, les implémentations de IDebugEventCallbacks ne doivent pas accéder à Bp après le retour du point d’arrêt .

Pour plus d’informations sur la gestion des événements, consultez Surveillance des événements. Pour plus d’informations sur la gestion des points d’arrêt, consultez Points d’arrêt.

Configuration requise