Dela via


ICorProfilerCallback::Avstängningsmetod

Meddelar profileraren att programmet stängs av.

Syntax

HRESULT Shutdown();  

Kommentarer

Profiler-koden kan inte anropa metoder för ICorProfilerInfo-gränssnittet när Shutdown metoden anropas. Alla anrop till ICorProfilerInfo metoder resulterar i odefinierat beteende när Shutdown metoden returneras. Vissa oföränderliga händelser kan fortfarande inträffa efter avstängningen. profileraren bör vara noga med att återvända omedelbart när detta inträffar.

Metoden Shutdown anropas endast om det hanterade programmet som profileras startas som hanterad kod (det vill sa att den första ramen i processstacken hanteras). Om programmet startade som ohanterad kod men senare hoppade in i hanterad kod och därmed skapade en instans av CLR (Common Language Runtime) anropas inte Shutdown . I dessa fall bör profileraren i sitt bibliotek inkludera en DllMain rutin som använder värdet DLL_PROCESS_DETACH för att frigöra resurser och utföra rensning av data, till exempel tömning av spårningar till disk och så vidare.

I allmänhet måste profileraren klara av oväntade avstängningar. En process kan till exempel stoppas av Win32-metoden TerminateProcess (deklareras i Winbase.h). I andra fall stoppar CLR vissa hanterade trådar (bakgrundstrådar) utan att leverera meddelanden om ordnad destruktion för dem.

Krav

Plattformar: Se Systemkrav.

Huvudet: CorProf.idl, CorProf.h

Bibliotek: CorGuids.lib

.NET Framework versioner: Tillgänglig sedan 2.0

Se även