ICorProfilerInfo2::GetNotifiedExceptionClauseInfo Method
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