Edit

ICorDebugManagedCallback Interface

  • Article

Provides methods to process debugger callbacks.

Methods

Method Description
Break Method Notifies the debugger when a Break instruction in the code stream is executed.
Breakpoint Method Notifies the debugger when a breakpoint is encountered.
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.
ControlCTrap Method Notifies the debugger that a CTRL+C is trapped in the process being debugged.
CreateAppDomain Method Notifies the debugger that an application domain has been created.
CreateProcess Method Notifies the debugger when a process has been attached or started for the first time.
CreateThread Method Notifies the debugger that a thread has started executing managed code.
DebuggerError Method Notifies the debugger that an error has occurred while attempting to handle an event from the CLR.
EditAndContinueRemap Method Deprecated. Notifies the debugger that a remap event has been sent to the IDE.
EvalComplete Method Notifies the debugger that an evaluation has been completed.
EvalException Method Notifies the debugger that an evaluation has been terminated with an unhandled exception.
Exception Method Notifies the debugger that an exception has been thrown from managed code.
ExitAppDomain Method Notifies the debugger that an application domain has exited.
ExitProcess Method Notifies the debugger that a process has exited.
ExitThread Method Notifies the debugger that a thread that was executing managed code has exited.
LoadAssembly Method Notifies the debugger that a CLR assembly has been successfully loaded.
LoadClass Method Notifies the debugger that a class has been loaded.
LoadModule Method Notifies the debugger that a CLR module has been successfully loaded.
LogMessage Method Notifies the debugger that a CLR managed thread has called a method in the EventLog class to log an event.
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.
NameChange Method Notifies the debugger that the name of either an application domain or thread has changed.
StepComplete Method Notifies the debugger that a step has completed.
UnloadAssembly Method Notifies the debugger that a CLR assembly has been unloaded.
UnloadClass Method Notifies the debugger that a class is being unloaded.
UnloadModule Method Notifies the debugger that a CLR module (DLL) has been unloaded.
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 System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: Available since 1.0

See also