Share via

ICorDebugManagedCallback2::Exception, méthode

  • Article

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 dans 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 dans 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

Notes

Le rappel Exception est appelé à différents points pendant la phase de recherche du processus de gestion des exceptions. Autrement dit, il peut être appelé 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 paramètre pThread.

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

Valeur de dwEventType Valeur de pFrame Valeur de nOffset
DEBUG_EXCEPTION_FIRST_CHANCE Frame qui a levé l’exception. Pointeur d’instruction dans le frame.
DEBUG_EXCEPTION_USER_FIRST_CHANCE Frame de code utilisateur le plus proche du point de l’exception levée. Pointeur d’instruction dans le frame.
DEBUG_EXCEPTION_CATCH_HANDLER_FOUND Frame contenant le gestionnaire catch. Décalage CIL (Common Intermediate Language) du début du gestionnaire catch.
DEBUG_EXCEPTION_UNHANDLED NULL Non défini.

Spécifications

Plateformes : Consultez Configuration requise.

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

Bibliothèque : CorGuids.lib

Versions de .NET Framework : Disponible depuis la version 2.0

Voir aussi