Edit

ICorProfilerInfo2::GetNotifiedExceptionClauseInfo Method

  • Article

Gets the native address and frame information for the exception clause (catch/finally/filter) that is about to be run or has just been run.

Syntax

HRESULT GetNotifiedExceptionClauseInfo(  
    [out] COR_PRF_EX_CLAUSE_INFO *pinfo);

Parameters

pinfo
[out] A pointer to a COR_PRF_EX_CLAUSE_INFO structure that describes the current exception clause instance and its associated frame.

Remarks

When an exception notification is received, GetNotifiedExceptionClauseInfo can be used to get the native address and frame information for the exception clause (catch/finally/filter) that is about to be run (ICorProfilerCallback::ExceptionCatcherEnter, ICorProfilerCallback::ExceptionUnwindFinallyEnter, or ICorProfilerCallback::ExceptionSearchFilterEnter callback is received by the profiler) or has just been run (ICorProfilerCallback::ExceptionCatcherLeave, ICorProfilerCallback::ExceptionUnwindFinallyLeave, or ICorProfilerCallback::ExceptionSearchFilterLeave callback is received by the profiler).

This call can be made at any time after one of the Enter callbacks above until either the matching Leave callback is received or a nested exception is thrown in the current clause, in which case there is no Leave notification for that clause. Note that it is not possible for a thrown exception to escape a filter exception clause, so there is always a Leave notification in that case.

Requirements

Platforms: See System Requirements.

Header: CorProf.idl, CorProf.h

Library: CorGuids.lib

.NET Framework Versions: Available since 2.0

See also