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;

Member

Description

clauseType

A value of the COR_PRF_CLAUSE_TYPE 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.

When an exception notification is received, ICorProfilerInfo2::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 or has just been run.

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

Platforms: See .NET Framework System Requirements.

Header: CorProf.idl

Library: CorGuids.lib

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

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft