COR_PRF_EX_CLAUSE_INFO Structure

Stores information about a specific exception clause instance and its associated frame.

typedef struct COR_PRF_EX_CLAUSE_INFO {
    COR_PRF_CLAUSE_TYPE clauseType;
    UINT_PTR programCounter;
    UINT_PTR framePointer;
    UINT_PTR shadowStackPointer;
} COR_PRF_EX_CLAUSE_INFO;

Members

Member	Description
clauseType	A value of the COR_PRF_CLAUSE_TYPE Enumeration enumeration that specifies the type of exception clause the code just entered or left.
programCounter	The native entry point of the clause handler — for example, the contents of the X86 EIP register.
framePointer	The pointer to the logical frame for the clause handler — for example, the contents of the X86 EBP register.
shadowStackPointer	The pointer to the shadow stack. This value is the contents of the BSP register and applies only to IA64.

Remarks

When an exception notification is received, ICorProfilerInfo2::GetNotifiedExceptionClauseInfo Method can be used to get the native address and frame information for the exception clause (catch/finally/filter) that is about to be run or has just been run.

Execution of an exception clause involves these callbacks from the common language runtime (CLR):

• ICorProfilerCallback::ExceptionCatcherEnter Method

• ICorProfilerCallback::ExceptionUnwindFinallyEnter Method

• ICorProfilerCallback::ExceptionSearchFilterEnter Method

• ICorProfilerCallback::ExceptionCatcherLeave Method

• ICorProfilerCallback::ExceptionUnwindFinallyLeave Method

• ICorProfilerCallback::ExceptionSearchFilterLeave Method

Requirements

Platforms: Windows 2000, Windows XP, Windows Server 2003 family

Header: CorProf.idl

Library: CorGuids.lib

.NET Framework Version: 2.0

See Also

Other Resources

Profiling Structures