COR_PRF_EX_CLAUSE_INFO-Struktur

Speichert Informationen über eine bestimmte Instanz einer Ausnahmeklausel und deren zugeordneten Rahmen.

Syntax

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

Member	BESCHREIBUNG
clauseType	Ein Wert der COR_PRF_CLAUSE_TYPE-Enumeration, der den Typ der Ausnahmeklausel angibt, die der Code gerade betreten oder verlassen hat.
programCounter	Der native Einstiegspunkt des Klauselhandlers, z. B. der Inhalt des X86-EIP-Registers.
framePointer	Der Zeiger auf den logischen Frame für den Klauselhandler: z. B. den Inhalt des X86 EBP-Registers.
shadowStackPointer	Der Zeiger auf den Schattenstapel. Dieser Wert ist der Inhalt des BSP-Registers und gilt nur für IA64.

Bemerkungen

Wenn eine Ausnahmebenachrichtigung empfangen wird, kann mithilfe von ICorProfilerInfo2::GetNotifiedExceptionClauseInfo die native Adresse und Frameinformationen für die Ausnahmeklausel (catch/finally/filter) abgerufen werden, die gerade ausgeführt werden soll oder wurde.

Die Ausführung einer Ausnahmeklausel umfasst diese Rückrufe aus der Common Language Runtime (CLR):

• ICorProfilerCallback::ExceptionCatcherEnter

• ICorProfilerCallback::ExceptionUnwindFinallyEnter

• ICorProfilerCallback::ExceptionSearchFilterEnter

• ICorProfilerCallback::ExceptionCatcherLeave

• ICorProfilerCallback::ExceptionUnwindFinallyLeave

• ICorProfilerCallback::ExceptionSearchFilterLeave

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: CorProf.idl

Bibliothek: CorGuids.lib

.NET Framework-Versionen: Seit 2.0 verfügbar.

Siehe auch

• Profilerstellungsstrukturen