Méthode IDebugEventCallbacksWide ::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 été rencontrée précédemment. Une valeur différente de zéro signifie qu’il s’agit de la première fois que l’exception a été 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 traite 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 IDebugEventCallbacksWide ::GetInterestMask.

Étant donné que la structure vers laquelle exception pointe peut être supprimée après le retour de cette méthode, les implémentations de IDebugEventCallbacksWide 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