Partilhar via


Método de ICorProfilerCallback::Shutdown

Notifica o profiler para que o aplicativo está sendo desligado.

HRESULT Shutdown();

Comentários

O código do profiler com segurança não é possível chamar métodos para a ICorProfilerInfo interface após a Shutdown método é chamado. Todas as chamadas para ICorProfilerInfo métodos resultam em um comportamento indefinido após a Shutdown método retorna. Certos eventos imutáveis ainda podem ocorrer após o desligamento; o profiler deve tomar cuidado para retornar imediatamente quando isso ocorre.

O Shutdown método será chamado somente se o aplicativo gerenciado que está sendo perfilado iniciado como código gerenciado (isto é, o quadro inicial na pilha de processo é gerenciado). Se o aplicativo foi iniciado como código não gerenciado, mas posteriormente entrou no código gerenciado, criando assim uma instância do common language runtime (CLR), em seguida, Shutdown não será chamado. Nesses casos, o profiler deve incluir na sua biblioteca de um DllMain rastreia de rotina que usa o valor DLL_PROCESS_DETACH para liberar os recursos e executar o processamento de limpeza de seus dados, como liberar para disco e assim por diante.

Em geral, o profiler deve lidar com os desligamentos inesperados. Por exemplo, um processo pode ser interrompido do Win32 TerminateProcess método (declarado em WinBase). Em outros casos, o CLR interromperá a determinados segmentos gerenciados (threads de plano de fundo) sem a entrega de mensagens de destruição ordenado para eles.

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::Initialize