ICorDebugManagedCallback Interface

 

Provides methods to process debugger callbacks.

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

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.

System_CAPS_ICON_note.jpg Note

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

Platforms: See System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: Available since 1.0

ICorDebug Interface
ICorDebugManagedCallback2 Interface
Debugging Interfaces

Show: