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