IDebugEventCallbacks interface (dbgeng.h)

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	Breakpoint	A breakpoint exception occurred in the target.
DEBUG_EVENT_EXCEPTION	Exception	An exception debugging event occurred in the target.
DEBUG_EVENT_CREATE_THREAD	CreateThread	A create-thread debugging event occurred in the target.
DEBUG_EVENT_EXIT_THREAD	ExitThread	An exit-thread debugging event occurred in the target.
DEBUG_EVENT_CREATE_PROCESS	CreateProcess	A create-process debugging event occurred in the target.
DEBUG_EVENT_EXIT_PROCESS	ExitProcess	An exit-process debugging event occurred in the target.
DEBUG_EVENT_LOAD_MODULE	LoadModule	A module-load debugging event occurred in the target.
DEBUG_EVENT_UNLOAD_MODULE	UnloadModule	A module-unload debugging event occurred in the target.
DEBUG_EVENT_SYSTEM_ERROR	SystemError	A system error occurred in the target.

 

The following events are generated by the debugger engine.

Flag	IDebugEventCallbacksMethod	Description
DEBUG_EVENT_SESSION_STATUS	SessionStatus	A change has occurred in the session status.
DEBUG_EVENT_CHANGE_DEBUGGEE_STATE	ChangeDebuggeeState	The engine has made or detected a change in the target status.
DEBUG_EVENT_CHANGE_ENGINE_STATE	ChangeEngineState	The engine state has changed.
DEBUG_EVENT_CHANGE_SYMBOL_STATE	ChangeSymbolState	The symbol state has changed.

Requirements

Requirement	Value
Target Platform	Windows
Header	dbgeng.h (include Dbgeng.h)