Partager via

ICorProfilerInfo2::GetNotifiedExceptionClauseInfo, méthode

  • Article

Obtient les informations d’adresse et de frame natives pour la clause d’exception (catch/finally/filter) qui est sur le point d’être exécutée ou qui vient d’être exécutée.

Syntaxe

HRESULT GetNotifiedExceptionClauseInfo(  
    [out] COR_PRF_EX_CLAUSE_INFO *pinfo);

Paramètres

pinfo
[out] Pointeur vers une structure COR_PRF_EX_CLAUSE_INFO qui décrit l’instance de clause d’exception actuelle et son frame associé.

Notes

Quand une notification d’exception est reçue, GetNotifiedExceptionClauseInfo peut servir à obtenir les informations d’adresse et de frame natives pour la clause d’exception (catch/finally/filter) sur le point d’être exécutée (le profileur reçoit un rappel ICorProfilerCallback::ExceptionCatcherEnter, ICorProfilerCallback::ExceptionUnwindFinallyEnter ou ICorProfilerCallback::ExceptionSearchFilterEnter) ou qui vient d’être exécutée (le profileur reçoit un rappel ICorProfilerCallback::ExceptionCatcherLeave, ICorProfilerCallback::ExceptionUnwindFinallyLeave ou ICorProfilerCallback::ExceptionSearchFilterLeave).

Cet appel peut être effectué à tout moment après l’un des rappels Enter ci-dessus jusqu’à ce que le rappel Leave correspondant soit reçu ou qu’une exception imbriquée soit levée dans la clause actuelle, auquel cas il n’existe aucune notification Leave pour cette clause. Notez qu’il n’est pas possible pour une exception levée d’échapper une clause d’exception filter. Il existe donc toujours une notification Leave dans ce cas.

Spécifications

Plateformes : Consultez Configuration requise.

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

Bibliothèque : CorGuids.lib

Versions de .NET Framework : Disponible depuis la version 2.0

Voir aussi