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