ICorProfilerInfo2::GetNotifiedExceptionClauseInfo, méthode

Article
08/10/2011

Obtient l'adresse native et les informations de frames 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.

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 la clause d'exception actuelle et le frame qui y est associé.

Notes

Lorsqu'une notification d'exception est reçue, GetNotifiedExceptionClauseInfo peut être utilisé pour obtenir l'adresse native et des informations sur les frames pour la clause d'exception (catch/finally/filter) qui est sur le point d'être exécutée (un rappel ICorProfilerCallback::ExceptionCatcherEnter, ICorProfilerCallback::ExceptionUnwindFinallyEnter ou ICorProfilerCallback::ExceptionSearchFilterEnter est reçu par le profileur) ou qui vient d'être exécutée (un rappel ICorProfilerCallback::ExceptionCatcherLeave, ICorProfilerCallback::ExceptionUnwindFinallyLeave ou ICorProfilerCallback::ExceptionSearchFilterLeave est reçu par le profileur).

Cet appel peut être réalisé à 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. Dans ce cas, il n'existe pas de notification leave pour cette clause. Notez qu'il est impossible à une exception levée d'échapper à une clause d'exception filter ; il existe donc toujours une notification leave dans ce cas.