ICorDebugManagedCallback2::Exception, méthode

Article
08/10/2011

Informe le débogueur qu'une recherche pour un gestionnaire d'exceptions a démarré.

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 qui contient 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 un frame déterminé par le paramètre dwEventType. Pour plus d'informations, consultez le tableau de la section Notes.
nOffset
[in] Entier qui spécifie un offset, comme déterminé par le paramètre dwEventType. Pour plus d'informations, consultez le tableau de la section Notes.
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 pendant le déroulement d'une exception.

L'exception qui est traitée peut être récupérée à partir de l'objet ICorDebugThread référencé par le paramètre pThread.

Le frame et l'offset 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	Le frame qui a levé l'exception.	Le pointeur d'instruction dans le frame.
DEBUG_EXCEPTION_USER_FIRST_CHANCE	Le frame de code d'utilisateur le plus proche du point de l'exception levée.	Le pointeur d'instruction dans le frame.
DEBUG_EXCEPTION_CATCH_HANDLER_FOUND	Le frame qui contient le gestionnaire catch.	L'offset MSIL (Microsoft Intermediate Language) du début du gestionnaire catch.
DEBUG_EXCEPTION_UNHANDLED	NULL	Indéfini.