Compartilhar via


Método ICorProfilerInfo2::GetNotifiedExceptionClauseInfo

Obtém as informações de endereço nativo e quadro para a cláusula de exceção (catch/finally/filter) que está prestes a ser executada ou acabou de ser executada.

Sintaxe

HRESULT GetNotifiedExceptionClauseInfo(  
    [out] COR_PRF_EX_CLAUSE_INFO *pinfo);  

Parâmetros

pinfo
[out] Um ponteiro para uma estrutura COR_PRF_EX_CLAUSE_INFO que descreve a instância da cláusula de exceção atual e seu quadro associado.

Comentários

Quando uma notificação de exceção é recebida, GetNotifiedExceptionClauseInfo pode ser usada para obter as informações do endereço nativo e do quadro para a cláusula de exceção (catch/finally/filter) que está prestes a ser executada (ICorProfilerCallback::ExceptionCatcherEnter, ICorProfilerCallback::ExceptionUnwindFinallyEnter ou ICorProfilerCallback::ExceptionSearchFilterEnter o retorno de chamada é recebido pelo criador de perfil) ou acabou de ser executado (ICorProfilerCallback::ExceptionCatcherLeave, ICorProfilerCallback::ExceptionUnwindFinallyLeave ou ICorProfilerCallback::ExceptionSearchFilterLeave o retorno de chamada é recebido pelo criador de perfil).

Essa chamada pode ser feita a qualquer momento após um dos retornos de chamada Enter acima até que o retorno de chamada de Leave correspondente seja recebido ou uma exceção aninhada seja lançada na cláusula atual, nesse caso, não há notificação Leave para essa cláusula. Observe que não é possível que uma exceção lançada escape de uma cláusula de exceção filter, portanto, sempre há uma notificação Leave nesse caso.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorProf.idl, CorProf.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: disponíveis desde 2.0

Confira também