Partager via


ICorDebugManagedCallback2 ::Exception, méthode

Avertit le débogueur qu’une recherche d’un gestionnaire d’exceptions a démarré.

Syntaxe

HRESULT Exception (
    [in] ICorDebugAppDomain   *pAppDomain,
    [in] ICorDebugThread      *pThread,
    [in] ICorDebugFrame       *pFrame,
    [in] ULONG32              nOffset,
    [in] CorDebugExceptionCallbackType dwEventType,
    [in] DWORD                dwFlags
);

Paramètres

pAppDomain [in] Pointeur vers un objet ICorDebugAppDomain qui représente le domaine d’application contenant le thread sur lequel l’exception a été levée.

pThread [in] Pointeur vers un objet ICorDebugThread qui représente le thread sur lequel l’exception a été levée.

pFrame [in] Pointeur vers un objet ICorDebugFrame qui représente une trame, tel que déterminé par le dwEventType paramètre. Pour plus d’informations, consultez le tableau de la section Remarques.

nOffset [in] Entier qui spécifie un décalage, tel que déterminé par le dwEventType paramètre. Pour plus d’informations, consultez le tableau de la section Remarques.

dwEventType [in] Valeur de l’énumération CorDebugExceptionCallbackType qui spécifie le type de ce rappel d’exception.

dwFlags [in] Valeur de l’énumération CorDebugExceptionFlags qui spécifie des informations supplémentaires sur l’exception

Remarques

Le Exception rappel est appelé à différents points pendant la phase de recherche du processus de gestion des exceptions. Autrement dit, elle peut être appelée plusieurs fois lors du déroulement d’une exception.

L’exception en cours de traitement peut être récupérée à partir de l’objet ICorDebugThread référencé par le pThread paramètre.

Le frame et le décalage particuliers sont déterminés par le dwEventType paramètre comme suit :

Valeur de dwEventType Valeur de pFrame Valeur de nOffset
DEBUG_EXCEPTION_FIRST_CHANCE Cadre qui a levé l’exception. Pointeur d’instruction dans le cadre.
DEBUG_EXCEPTION_USER_FIRST_CHANCE Cadre de code utilisateur le plus proche du point de l’exception levée. Pointeur d’instruction dans le cadre.
DEBUG_EXCEPTION_CATCH_HANDLER_FOUND Frame qui contient le gestionnaire catch. Décalage CIL (Common Intermediate Language) du début du gestionnaire catch.
DEBUG_EXCEPTION_UNHANDLED ZÉRO Indéfini.

Spécifications

Plates-formes: Consultez les systèmes d’exploitation pris en charge par .NET.

En-tête: CorDebug.idl, CorDebug.h

Bibliothèque: CorGuids.lib

Versions de .NET : Disponible depuis .NET Framework 2.0

Voir aussi