Método de ICorProfilerInfo2::GetNotifiedExceptionClauseInfo

Artigo
08/08/2011

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

HRESULT GetNotifiedExceptionClauseInfo(
    [out] COR_PRF_EX_CLAUSE_INFO *pinfo);

Parâmetros

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

Comentários

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

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