Partilhar via


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

Ver também