ICorDebugManagedCallback-Schnittstelle

Artikel
08/10/2011

Stellt Methoden zum Verarbeiten von Debuggerrückrufen zur Verfügung.

Methoden

Methode	Beschreibungen
ICorDebugManagedCallback::Break-Methode	Benachrichtigt den Debugger, wenn eine Break-Anweisung im Codestream ausgeführt wird.
ICorDebugManagedCallback::Breakpoint-Methode	Benachrichtigt den Debugger, wenn ein Haltepunkt erreicht wird.
ICorDebugManagedCallback::BreakpointSetError-Methode	Benachrichtigt den Debugger, dass die Common Language Runtime (CLR) nicht in der Lage war, einen Haltepunkt korrekt zu binden, der vor der JIT-Kompilierung (Just-In-Time) einer Funktion festgelegt wurde.
ICorDebugManagedCallback::ControlCTrap-Methode	Benachrichtigt den Debugger, dass ein STRG+C im Prozess aufgefangen wird, der gedebuggt wird.
ICorDebugManagedCallback::CreateAppDomain-Methode	Benachrichtigt den Debugger, dass eine Anwendungsdomäne erstellt wurde.
ICorDebugManagedCallback::CreateProcess-Methode	Benachrichtigt den Debugger, wenn ein Prozess angehängt oder zu dem ersten Mal gestartet wurde.
ICorDebugManagedCallback::CreateThread-Methode	Benachrichtigt den Debugger, dass ein Thread mit der Ausführung von verwaltetem Code begonnen hat.
ICorDebugManagedCallback::DebuggerError-Methode	Benachrichtigt den Debugger, dass beim Versuch, ein Ereignis der CLR zu behandeln, ein Fehler aufgetreten ist.
ICorDebugManagedCallback::EditAndContinueRemap-Methode	Diese Option ist veraltet. Benachrichtigt den Debugger, dass ein Neuzuordnungsereignis an die IDE gesendet wurde.
ICorDebugManagedCallback::EvalComplete-Methode	Benachrichtigt den Debugger, dass eine Evaluierung abgeschlossen wurde.
ICorDebugManagedCallback::EvalException-Methode	Benachrichtigt den Debugger, dass eine Evaluierung mit einer nicht behandelten Ausnahme beendet wurde.
ICorDebugManagedCallback::Exception-Methode	Benachrichtigt den Debugger, dass eine Ausnahme von verwaltetem Code ausgelöst wurde.
ICorDebugManagedCallback::ExitAppDomain-Methode	Benachrichtigt den Debugger, dass eine Anwendungsdomäne beendet wurde.
ICorDebugManagedCallback::ExitProcess-Methode	Benachrichtigt den Debugger, dass ein Prozess beendet wurde.
ICorDebugManagedCallback::ExitThread-Methode	Benachrichtigt den Debugger, dass ein Thread, der verwalteten Code ausführte, beendet wurde.
ICorDebugManagedCallback::LoadAssembly-Methode	Benachrichtigt den Debugger, dass eine CLR-Assembly erfolgreich geladen wurde.
ICorDebugManagedCallback::LoadClass-Methode	Benachrichtigt den Debugger, dass eine Klasse geladen wurde.
ICorDebugManagedCallback::LoadModule-Methode	Benachrichtigt den Debugger, dass ein CLR-Modul erfolgreich geladen wurde.
ICorDebugManagedCallback::LogMessage-Methode	Benachrichtigt den Debugger, dass ein von der CLR verwalteter Thread eine Methode in der EventLog-Klasse aufgerufen hat, um ein Ereignis zu protokollieren.
ICorDebugManagedCallback::LogSwitch-Methode	Benachrichtigt den Debugger, dass ein von der CLR verwalteter Thread eine Methode in der Switch-Klasse aufgerufen hat, um einen Schalter für Debuggen/Ablaufverfolgung zu erstellen, zu ändern oder zu löschen.
ICorDebugManagedCallback::NameChange-Methode	Benachrichtigt den Debugger, dass sich der Name einer Anwendungsdomäne oder eines Threads geändert hat.
ICorDebugManagedCallback::StepComplete-Methode	Benachrichtigt den Debugger, dass ein Schritt abgeschlossen worden ist.
ICorDebugManagedCallback::UnloadAssembly-Methode	Benachrichtigt den Debugger, dass eine CLR-Assembly entladen wurde.
ICorDebugManagedCallback::UnloadClass-Methode	Benachrichtigt den Debugger, dass eine Klasse entladen wird.
ICorDebugManagedCallback::UnloadModule-Methode	Benachrichtigt den Debugger, dass ein CLR-Modul (DLL) entladen wurde.
ICorDebugManagedCallback::UpdateModuleSymbols-Methode	Benachrichtigt den Debugger, dass sich die Symbole für ein CLR-Modul geändert haben.

Hinweise

Alle Rückrufe sind serialisiert, werden in demselben Thread und mit dem Prozess im synchronisierten Zustand aufgerufen.

Jede Rückrufimplementierung muss ICorDebugController::Continue aufrufen, um die Ausführung fortzusetzen. Wenn ICorDebugController::Continue nicht vor der Rückgabe des Rückrufs aufgerufen wird, bleibt der Prozess angehalten. Es treten keine weiteren Ereignisrückrufe auf, bis ICorDebugController::Continue aufgerufen wird.

Ein Debugger muss ICorDebugManagedCallback2 implementieren, wenn er Anwendungen für .NET Framework, Version 2.0, debuggt. Eine Instanz von ICorDebugManagedCallback oder ICorDebugManagedCallback2 wird als Rückrufobjekt an ICorDebug::SetManagedHandler übergeben.