Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Inheritance
The IDebugEventCallbacks interface inherits from the IUnknown interface. IDebugEventCallbacks also has these types of members:
Methods
The IDebugEventCallbacks interface has these methods.
| IDebugEventCallbacks::Breakpoint The Breakpoint callback method is called by the engine when the target issues a breakpoint exception. |
| IDebugEventCallbacks::ChangeDebuggeeState The ChangeDebuggeeState callback method is called by the engine when it makes or detects changes to the target. This method belongs to IDebugEventCallbacks. |
| IDebugEventCallbacks::ChangeEngineState The ChangeEngineState callback method is called by the engine when its state has changed. This method belongs to the IDebugEventCallbacks interface. |
| IDebugEventCallbacks::ChangeSymbolState The ChangeSymbolState callback method is called by the engine when the symbol state changes. This method belongs to the IDebugEventCallbacks interface. |
| IDebugEventCallbacks::CreateProcess The CreateProcess callback method is called by the engine when a create-process debugging event occurs in the target. This method belongs to IDebugEventCallbacks. |
| IDebugEventCallbacks::CreateThread The CreateThread callback method is called by the engine when a create-threaddebugging event occurs in the target. This method belongs to IDebugEventCallbacks. |
| IDebugEventCallbacks::Exception The Exception callback method is called by the engine when an exception debugging event occurs in the target. This method belongs to IDebugEventCallbacks. |
| IDebugEventCallbacks::ExitProcess The ExitProcess callback method is called by the engine when an exit-process debugging event occurs in the target. This method belongs to IDebugEventCallbacks. |
| IDebugEventCallbacks::ExitThread The ExitThread callback method is called by the engine when an exit-thread debugging event occurs in the target. This method belongs to IDebugEventCallbacks. |
| IDebugEventCallbacks::GetInterestMask The GetInterestMask callback method is called to determine which events the IDebugEventCallbacks object is interested in. The engine calls GetInterestMask when the object is registered with a client by using SetEventCallbacks. |
| IDebugEventCallbacks::LoadModule The LoadModule callback method is called by the engine when a module-load debugging event occurs in the target. This method belongs to IDebugEventCallbacks. |
| IDebugEventCallbacks::SessionStatus The SessionStatus callback method is called by the engine when a change occurs in the debugger session. This method belongs to IDebugEventCallbacks. |
| IDebugEventCallbacks::SystemError The SystemError callback method is called by the engine when a system error occurs in the target. This method belongs to the IDebugEventCallbacks interface. |
| IDebugEventCallbacks::UnloadModule The UnloadModule callback method is called by the engine when a module-unload debugging event occurs in the target. This method belongs to IDebugEventCallbacks. |
Remarks
The IDebugEventCallbacksWide interface includes Unicode versions of these methods; the Unicode methods share the same names as those used by the methods in IDebugEventCallbacks.
The following events are generated by the target.
| Flag | IDebugEventCallbacksMethod | Event Description |
|---|---|---|
| DEBUG_EVENT_BREAKPOINT | A breakpoint exception occurred in the target. | |
| DEBUG_EVENT_EXCEPTION | An exception debugging event occurred in the target. | |
| DEBUG_EVENT_CREATE_THREAD | A create-thread debugging event occurred in the target. | |
| DEBUG_EVENT_EXIT_THREAD | An exit-thread debugging event occurred in the target. | |
| DEBUG_EVENT_CREATE_PROCESS | A create-process debugging event occurred in the target. | |
| DEBUG_EVENT_EXIT_PROCESS | An exit-process debugging event occurred in the target. | |
| DEBUG_EVENT_LOAD_MODULE | A module-load debugging event occurred in the target. | |
| DEBUG_EVENT_UNLOAD_MODULE | A module-unload debugging event occurred in the target. | |
| DEBUG_EVENT_SYSTEM_ERROR | A system error occurred in the target. |
The following events are generated by the debugger engine.
| Flag | IDebugEventCallbacksMethod | Description |
|---|---|---|
| DEBUG_EVENT_SESSION_STATUS | A change has occurred in the session status. | |
| DEBUG_EVENT_CHANGE_DEBUGGEE_STATE | The engine has made or detected a change in the target status. | |
| DEBUG_EVENT_CHANGE_ENGINE_STATE | The engine state has changed. | |
| DEBUG_EVENT_CHANGE_SYMBOL_STATE | The symbol state has changed. |
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | dbgeng.h (include Dbgeng.h) |