Share via


ICorDebugManagedCallback Interface

Provides methods to process debugger callbacks.

Methods

Method

Description

ICorDebugManagedCallback::Break Method

Notifies the debugger when a Break instruction in the code stream is executed.

ICorDebugManagedCallback::Breakpoint Method

Notifies the debugger when a breakpoint is encountered.

ICorDebugManagedCallback::BreakpointSetError Method

Notifies the debugger that the common language runtime (CLR) was unable to accurately bind a breakpoint that was set before a function was just-in-time (JIT) compiled.

ICorDebugManagedCallback::ControlCTrap Method

Notifies the debugger that a CTRL+C is trapped in the process being debugged.

ICorDebugManagedCallback::CreateAppDomain Method

Notifies the debugger that an application domain has been created.

ICorDebugManagedCallback::CreateProcess Method

Notifies the debugger when a process has been attached or started for the first time.

ICorDebugManagedCallback::CreateThread Method

Notifies the debugger that a thread has started executing managed code.

ICorDebugManagedCallback::DebuggerError Method

Notifies the debugger that an error has occurred while attempting to handle an event from the CLR.

ICorDebugManagedCallback::EditAndContinueRemap Method

Deprecated. Notifies the debugger that a remap event has been sent to the IDE.

ICorDebugManagedCallback::EvalComplete Method

Notifies the debugger that an evaluation has been completed.

ICorDebugManagedCallback::EvalException Method

Notifies the debugger that an evaluation has been terminated with an unhandled exception.

ICorDebugManagedCallback::Exception Method

Notifies the debugger that an exception has been thrown from managed code.

ICorDebugManagedCallback::ExitAppDomain Method

Notifies the debugger that an application domain has exited.

ICorDebugManagedCallback::ExitProcess Method

Notifies the debugger that a process has exited.

ICorDebugManagedCallback::ExitThread Method

Notifies the debugger that a thread that was executing managed code has exited.

ICorDebugManagedCallback::LoadAssembly Method

Notifies the debugger that a CLR assembly has been successfully loaded.

ICorDebugManagedCallback::LoadClass Method

Notifies the debugger that a class has been loaded.

ICorDebugManagedCallback::LoadModule Method

Notifies the debugger that a CLR module has been successfully loaded.

ICorDebugManagedCallback::LogMessage Method

Notifies the debugger that a CLR managed thread has called a method in the EventLog class to log an event.

ICorDebugManagedCallback::LogSwitch Method

Notifies the debugger that a CLR managed thread has called a method in the Switch class to create, modify, or delete a debugging/tracing switch.

ICorDebugManagedCallback::NameChange Method

Notifies the debugger that the name of either an application domain or thread has changed.

ICorDebugManagedCallback::StepComplete Method

Notifies the debugger that a step has completed.

ICorDebugManagedCallback::UnloadAssembly Method

Notifies the debugger that a CLR assembly has been unloaded.

ICorDebugManagedCallback::UnloadClass Method

Notifies the debugger that a class is being unloaded.

ICorDebugManagedCallback::UnloadModule Method

Notifies the debugger that a CLR module (DLL) has been unloaded.

ICorDebugManagedCallback::UpdateModuleSymbols Method

Notifies the debugger that the symbols for a CLR module have changed.

Remarks

All callbacks are serialized, called in the same thread, and called with the process in the synchronized state.

Each callback implementation must call ICorDebugController::Continue to resume execution. If ICorDebugController::Continue is not called before the callback returns, the process will remain stopped and no more event callbacks will occur until ICorDebugController::Continue is called.

A debugger must implement ICorDebugManagedCallback2 if it is debugging .NET Framework version 2.0 applications. An instance of ICorDebugManagedCallback or ICorDebugManagedCallback2 is passed as the callback object to ICorDebug::SetManagedHandler.

Note

This interface does not support being called remotely, either cross-machine or cross-process.

Requirements

Platforms: See .NET Framework System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0

See Also

Reference

ICorDebug Interface

ICorDebugManagedCallback2 Interface

Other Resources

Debugging Interfaces