Delen via


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.

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 .NET Framework System Requirements.

Header: CorProf.idl

Library: CorGuids.lib

.NET Framework Versions: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

See Also

Reference

ICorProfilerInfo Interface

ICorProfilerInfo2 Interface