Freigeben über


ICorProfilerCallback3::ProfilerDetachSucceeded-Methode

Benachrichtigt den Profiler, dass die Common Language Runtime (CLR) im Begriff ist, die Profiler-DLL zu entladen.

HRESULT ProfilerDetachSucceeded();

Rückgabewert

Der Rückgabewert von diesem Rückruf wird ignoriert.

Hinweise

Der ProfilerDetachSucceeded-Rückruf wird ausgegeben, nachdem alle Threads den Code des Profilers verlassen haben. Wenn diese Methode aufgerufen wird, sollte der Profiler ggf. in letzter Minute anfallende Aufgaben ausführen, die für seinen Destruktor nicht geeignet sind, z. B. Benachrichtigen der Benutzeroberfläche oder Protokollierungskomponente. Der Profiler darf jedoch keine Funktionen für Schnittstellen aufrufen, die von der CLR während dieses Rückrufs bereitgestellt werden (z. B. die ICorProfilerInfo-Schnittstelle oder die IMetaData*-Schnittstelle).

Die CLR erstellt einen Eintrag im Windows-Anwendungsereignisprotokoll, um anzugeben, dass der Trennvorgang erfolgreich war.

Nachdem der Profiler aus diesem Rückruf zurückgekehrt ist, gibt die CLR das Profilerobjekt frei und entlädt die Profiler-DLL. Daher darf der Profiler nach dem Abschluss dieses Rückrufs keine Aktionen ausführen, die eine Ausführung in der Profiler-DLL verursachen. Beispielsweise darf er keine Threads erstellen oder Zeitgeberrückrufe registrieren.

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: CorProf.idl, CorProf.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: 4

Siehe auch

Referenz

ICorProfilerInfo3-Schnittstelle

Konzepte

Anfügen und Trennen des Profilers

Weitere Ressourcen

Metadatenschnittstellen

Profilerstellungsschnittstellen

Profilerstellung (Referenz zur nicht verwalteten API)