IDebugEventCallbacksWide::Exception method

The Exception callback method is called by the engine when an exceptiondebugging event occurs in the target.


HRESULT Exception(
  ULONG               FirstChance



Specifies the nature of the exception. EXCEPTION_RECORD64 is defined in Winnt.h.


Specifies whether this exception has been previously encountered. A nonzero value means that this is the first time the exception has been encountered ("first chance"). A zero value means that the exception has already been offered to all possible handlers, and each one declined to handle it ("second chance").

Return Value

This method returns a DEBUG_STATUS_XXX value, which indicates how the execution of the target should proceed after the engine processes this event. For details on how the engine treats this value, see Monitoring Events.


This method is only called by the engine if the DEBUG_EVENT_EXCEPTION flag is set in the mask returned by IDebugEventCallbacksWide::GetInterestMask.

Because the structure that Exception points to might be deleted after this method returns, implementations of IDebugEventCallbacksWide should not access this structure after returning.

For more information about handling events, see Monitoring Events.


Target Platform Desktop
Header dbgeng.h (include Dbgeng.h)