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

La méthode de rappel d’exception est appelée par le moteur lorsqu’un événement de débogage d’exception se produit dans la cible.

Syntaxe

HRESULT Exception(
  [in] PEXCEPTION_RECORD64 Exception,
  [in] ULONG               FirstChance
);

Paramètres

[in] Exception

Spécifie la nature de l’exception. EXCEPTION_RECORD64 est défini dans winnt.h.

[in] FirstChance

Spécifie si cette exception a déjà été rencontrée. Une valeur différente de zéro signifie qu’il s’agit de la première fois que l’exception est rencontrée (« première chance »). Une valeur zéro signifie que l’exception a déjà été proposée à tous les gestionnaires possibles et que chacun d’eux a refusé de la gérer (« deuxième chance »).

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

Cette méthode n’est appelée par le moteur que si l’indicateur DEBUG_EVENT_EXCEPTION est défini dans le masque retourné par IDebugEventCallbacks ::GetInterestMask.

Étant donné que la structure vers laquelle pointe Exception peut être supprimée après le retour de cette méthode, les implémentations de IDebugEventCallbacks ne doivent pas accéder à cette structure après le retour.

Pour plus d’informations sur la gestion des événements, consultez Surveillance des événements.

Configuration requise

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