IDebugEventCallbacksWide ::Exception, méthode (dbgeng.h)

Article
02/06/2025

La méthode de rappel exception est appelée par le moteur lorsqu’une exception événement de débogage 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 que c’est la première fois que l’exception a été rencontrée (« première chance »). Une valeur nulle signifie que l’exception a déjà été proposée à tous les gestionnaires possibles, et chacune d’elles a refusé de la gérer (« deuxième chance »).

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

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

Étant donné que la structure à laquelle exception points peut être supprimée une fois cette méthode retournée, 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 Monitoring Events.

Exigences

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

Partager via