Compartilhar via


Método 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

The ExceptionCatcherEnter método é chamado somente se o ponto de catch estiver em código compilado com o compilador do just-in-time (JIT). Uma exceção é detectada no código não gerenciado ou no código interno do tempo de execução não irá telefonar esta notificação. The objectId valor é 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 em sua implementação desse método porque a pilha pode não ser em um estado que permita que lixo coleção e portanto preventivo lixo coleção não pode ser ativado. Se o criador de perfil bloquear aqui e a tentativa de coleta de lixo, o tempo de execução será bloqueado até que esse retorno de chamada retorne.

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

Requisitos

Plataformas: See Requisitos de sistema do .NET framework.

Cabeçalho: CorProf.idl

Biblioteca: CorGuids.lib

.NET Framework Versions: 3.5 SP1, 3,5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Consulte também

Referência

Interface ICorProfilerCallback

Método ICorProfilerCallback::ExceptionCatcherLeave