ICorProfilerInfo2::GetNotifiedExceptionClauseInfo-Methode

Artikel
08/10/2011

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.