Método ICorProfilerCallback::Shutdown
Notifica o gerador de perfis de que a aplicação está a encerrar.
Syntax
HRESULT Shutdown();
Observações
O código do gerador de perfis não pode chamar com segurança métodos da interface ICorProfilerInfo após o Shutdown
método ser chamado. Quaisquer chamadas para ICorProfilerInfo
métodos resultam num comportamento indefinido após a devolução do Shutdown
método. Determinados eventos imutáveis podem continuar a ocorrer após o encerramento; O gerador de perfis deve ter o cuidado de devolver imediatamente quando isto ocorrer.
O Shutdown
método será chamado apenas se a aplicação gerida que está a ser criada com perfis tiver sido iniciada como código gerido (ou seja, se o fotograma inicial na pilha de processos for gerido). Se a aplicação tiver sido iniciada como código não gerido, mas posteriormente passar para o código gerido, a criação de uma instância do runtime de linguagem comum (CLR) Shutdown
não será chamada. Nestes casos, o gerador de perfis deve incluir na respetiva biblioteca uma DllMain
rotina que utiliza o valor DLL_PROCESS_DETACH para libertar quaisquer recursos e efetuar o processamento de limpeza dos respetivos dados, como remover rastreios para o disco e assim sucessivamente.
Em geral, o gerador de perfis tem de lidar com encerramentos inesperados. Por exemplo, um processo pode ser interrompido pelo método win32 TerminateProcess
(declarado em Winbase.h). Noutros casos, o CLR irá parar determinados threads geridos (threads em segundo plano) sem fornecer mensagens de destruição ordenada para os mesmos.
Requisitos
Plataformas: Veja Requisitos de Sistema.
Cabeçalho: CorProf.idl, CorProf.h
Biblioteca: CorGuids.lib
.NET Framework Versões: Disponível desde 2.0