Methode ICorProfilerCallback::Shutdown
Hiermee wordt de profiler gewaarschuwd dat de toepassing wordt afgesloten.
Syntax
HRESULT Shutdown();
Opmerkingen
De profilercode kan methoden van de ICorProfilerInfo-interface niet veilig aanroepen nadat de Shutdown methode is aangeroepen. Aanroepen van ICorProfilerInfo methoden resulteren in niet-gedefinieerd gedrag nadat de Shutdown methode is geretourneerd. Bepaalde onveranderbare gebeurtenissen kunnen nog steeds optreden na het afsluiten; de profiler moet ervoor zorgen dat deze onmiddellijk terugkeert wanneer dit gebeurt.
De Shutdown methode wordt alleen aangeroepen als de beheerde toepassing die wordt geprofileerd, is gestart als beheerde code (het oorspronkelijke frame op de processtack wordt beheerd). Als de toepassing is gestart als niet-beheerde code, maar later in beheerde code is gesprongen, waardoor een exemplaar van de Common Language Runtime (CLR) wordt gemaakt, wordt dit Shutdown niet aangeroepen. Voor deze gevallen moet de profiler in de bibliotheek een DllMain routine opnemen die de waarde DLL_PROCESS_DETACH gebruikt om resources vrij te maken en de opschoning van de gegevens uit te voeren, zoals het leegmaken van traceringen naar schijf, enzovoort.
Over het algemeen moet de profiler omgaan met onverwachte afsluitingen. Een proces kan bijvoorbeeld worden gestopt door de methode van TerminateProcess Win32 (gedeclareerd in Winbase.h). In andere gevallen stopt de CLR bepaalde beheerde threads (achtergrondthreads) zonder ordelijke vernietigingsberichten voor hen af te leveren.
Vereisten
Platforms: Zie Systeemvereisten.
Header: CorProf.idl, CorProf.h
Bibliotheek: CorGuids.lib
.NET Framework versies: beschikbaar sinds 2.0
