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
| Parameter | Description |
|---|---|
pinfo |
[out] A pointer to a COR_PRF_EX_CLAUSE_INFO Structure 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 Method, ICorProfilerCallback::ExceptionUnwindFinallyEnter Method, or ICorProfilerCallback::ExceptionSearchFilterEnter Method callback is received by the profiler) or has just been run (ICorProfilerCallback::ExceptionCatcherLeave Method, ICorProfilerCallback::ExceptionUnwindFinallyLeave Method, or ICorProfilerCallback::ExceptionSearchFilterLeave Method 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: Windows 2000, Windows XP, Windows Server 2003 family
Header: CorProf.idl
Library: CorGuids.lib
.NET Framework Version: 2.0