Compartilhar via


Método ICorProfilerCallback::ExceptionCatcherEnter

Notifica o criador de perfil de que o controle está sendo passado para o bloco catch apropriado.

Sintaxe

HRESULT ExceptionCatcherEnter(  
    [in] FunctionID functionId,  
    [in] ObjectID   objectId);  

Parâmetros

functionId
[in] O identificador da função que contém o bloco catch.

objectId
[in] O identificador da exceção que está sendo tratada.

Comentários

O método ExceptionCatcherEnter será chamado somente se o ponto de captura estiver no código compilado com o compilador JIT (just-in-time). Uma exceção que é capturada em código não gerenciado ou no código interno do runtime não chamará essa notificação. O valor objectId é passado novamente, pois uma coleta de lixo pode ter movido o objeto desde a ExceptionThrown notificação.

O criador de perfil não deve bloquear a implementação desse método porque a pilha pode não estar em um estado que permita a coleta de lixo e, portanto, pode não ser possível habilitar a coleta de lixo preemptiva. Se o criador de perfil fizer um bloqueio e for realizada uma tentativa de coleta de lixo, o runtime será bloqueado até que esse retorno de chamada seja retornado.

A implementação desse método pelo criador de perfil não deve chamar códigos gerenciados ou causar uma alocação de memória gerenciada.

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