ICorProfilerInfo2::GetNotifiedExceptionClauseInfo-Methode
Aktualisiert: November 2007
Ruft die systemeigene Adress- und Rahmeninformationen für die Ausnahmeklausel (catch/finally/filter) ab, die kurz vor der Ausführung steht oder gerade ausgeführt wurde.
HRESULT GetNotifiedExceptionClauseInfo(
[out] COR_PRF_EX_CLAUSE_INFO *pinfo);
Parameter
- pinfo
[out] Ein Zeiger auf eine COR_PRF_EX_CLAUSE_INFO-Struktur, die die aktuelle Ausnahmeklausel und deren zugeordneten Rahmen beschreibt.
Hinweise
Beim Empfang einer Ausnahmebenachrichtigung kann GetNotifiedExceptionClauseInfo verwendet werden, um die systemeigenen Adress- und Rahmeninformationen für die Ausnahmeklausel (catch/finally/filter) abzurufen, die kurz vor der Ausführung steht (der Rückruf ICorProfilerCallback::ExceptionCatcherEnter, ICorProfilerCallback::ExceptionUnwindFinallyEnter oder ICorProfilerCallback::ExceptionSearchFilterEnter wird vom Profiler empfangen) oder gerade ausgeführt wurde (der Rückruf ICorProfilerCallback::ExceptionCatcherLeave, ICorProfilerCallback::ExceptionUnwindFinallyLeave oder ICorProfilerCallback::ExceptionSearchFilterLeave wird vom Profiler empfangen).
Dieser Rückruf kann jederzeit nach einem der oben genannten Enter-Rückrufe ausgeführt werden, nachdem entweder der übereinstimmende Leave-Rückruf empfangen oder eine verschachtelte Ausnahme in der aktuellen Klausel ausgelöst wurde. In diesem Fall wird keine Leave-Benachrichtigung für diese Klausel ausgegeben. Beachten Sie, dass es für eine ausgelöste Ausnahme nicht möglich ist, eine filter-Ausnahmeklausel zu verlassen, sodass in diesem Fall immer eine Leave-Benachrichtigung ausgegeben wird.
Anforderungen
Plattformen: siehe Systemanforderungen für .NET Framework.
Header: CorProf.idl
Bibliothek: CorGuids.lib
.NET Framework-Versionen: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0