IDebugEventCallbacksWide::Exception method

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

Syntax

HRESULT Exception(
  PEXCEPTION_RECORD64 Exception,
  ULONG               FirstChance
);

Parameters

Exception

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

FirstChance

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.

Remarks

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.

Requirements

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