Compartilhar via


Método de ICorProfilerCallback::ExceptionCatcherEnter

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

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

Parâmetros

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

  • objectId
    [in] O identificador da exceção sendo manipulado.

Comentários

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

O profiler não deve bloquear em sua implementação deste método porque a pilha não pode estar em um estado que permite a coleta de lixo e, portanto, a coleta de lixo preventivo e não pode ser ativada. Se o profiler bloqueia aqui e coleta de lixo é tentada, o runtime irá bloquear até que esse retorno de chamada retorne.

A implementação do criador de perfil desse método não deve chamar código gerenciado ou em qualquer causa de forma uma alocação de memória gerenciada.

Requisitos

Plataformas: Consulte Requisitos de sistema do .NET Framework.

Cabeçalho: Corprof. idl, CorProf.h

Biblioteca: CorGuids.lib

.NET Framework versões: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Consulte também

Referência

Interface de ICorProfilerCallback

Método de ICorProfilerCallback::ExceptionCatcherLeave