ICorDebugManagedCallback Interface
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
