Метод ICorProfilerInfo2::GetNotifiedExceptionClauseInfo

  • Статья

Возвращает собственный адрес и сведения о фрейме для предложения исключения (catch//finallyfilter), которое должно быть выполнено или только что было выполнено.

Синтаксис

HRESULT GetNotifiedExceptionClauseInfo(  
    [out] COR_PRF_EX_CLAUSE_INFO *pinfo);

Параметры

pinfo
[out] Указатель на структуру COR_PRF_EX_CLAUSE_INFO , описывающую текущий экземпляр предложения исключения и связанный с ним кадр.

Комментарии

При получении уведомления об исключении GetNotifiedExceptionClauseInfo можно использовать для получения собственных сведений об адресе и кадре для предложения исключения (finally/catchfilter/), которое должно быть выполнено (ICorProfilerCallback::ExceptionCatcherEnter, ICorProfilerCallback::ExceptionUnwindFinallyEnter или ICorProfilerCallback::ExceptionSearchFilterEnter получает обратный вызов профилировщика) или только что было выполнено (ICorProfilerCallback::ExceptionCatcherLeave, ICorProfilerCallback::ExceptionUnwindFinallyLeave или ICorProfilerCallback::ExceptionSearchFilterLeave получает обратный вызов профилировщика).

Этот вызов можно выполнить в любое время после одного из приведенных выше обратных вызовов Enter, пока не будет получен соответствующий обратный вызов Leave или вложенное исключение в текущем предложении. В этом случае уведомление о выходе для этого предложения не будет. Обратите внимание, что для созданного исключения невозможно экранировать filter предложение исключения, поэтому в этом случае всегда есть уведомление о выходе.

Требования

Платформы: см. раздел Требования к системе.

Заголовок: CorProf.idl, CorProf.h

Библиотека: CorGuids.lib

версии платформа .NET Framework: доступно с версии 2.0.

См. также раздел