Sdílet prostřednictvím

ICorProfilerCallback::Shutdown – metoda

  • Článek

Upozorní profiler, že se aplikace vypíná.

Syntax

HRESULT Shutdown();

Poznámky

Kód profileru nemůže bezpečně volat metody rozhraní ICorProfilerInfo po Shutdown volání metody. Všechna volání ICorProfilerInfo metod mají za následek nedefinované chování po Shutdown vrácení metody. Některé neměnné události mohou stále nastat po vypnutí; profiler by se měl postarat o to, aby se vrátil okamžitě, jakmile k tomu dojde.

Metoda Shutdown bude volána pouze v případě, že se spravovaná aplikace, která je profilovaná, spustila jako spravovaný kód (to znamená, že se spravuje počáteční rámec v zásobníku procesu). Pokud se aplikace spustila jako nespravovaný kód, ale později přeskočila do spravovaného kódu, čímž se vytvořila instance modulu CLR (Common Language Runtime), Shutdown nebude volána. V těchto případech by měl profiler zahrnout do své knihovny rutinu DllMain , která používá hodnotu DLL_PROCESS_DETACH k uvolnění prostředků a vyčištění dat, jako je vyprázdnění trasování na disk atd.

Obecně platí, že profiler se musí vypořádat s neočekávanými vypnutími. Proces může být například zastaven metodou Win32 TerminateProcess (deklarovanou v souboru Winbase.h). V jiných případech CLR zastaví některá spravovaná vlákna (vlákna na pozadí), aniž by jim doručovala zprávy o řádném zničení.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: CorProf.idl, CorProf.h

Knihovny: CorGuids.lib

Verze rozhraní .NET Framework: K dispozici od verze 2.0

Viz také