IDebugEventCallbacks ::Breakpoint, méthode (dbgeng.h)

Le point d’arrêt méthode de rappel 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 déclenché.

Valeur de retour

Cette méthode retourne une valeur DEBUG_STATUS_XXX, qui indique comment l’exécution de la cible doit se poursuivre après que le moteur traite cet événement. Pour plus d’informations sur la façon dont le moteur traite cette valeur, consultez Monitoring Events.

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 appelle cette méthode uniquement 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, en utilisant RemoveBreakpoint), la valeur de Bp peut ne pas être valide après retour du point d’arrêt. Par conséquent, les implémentations de IDebugEventCallbacks ne doivent pas accéder à Bp après retour du point d’arrêt.

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

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	dbgeng.h (include Dbgeng.h)