Share via


IDebugExceptionEvent2::PassToDebuggee

Specifies whether the exception should be passed on to the program being debugged when execution resumes, or if the exception should be discarded.

HRESULT PassToDebuggee(
   BOOL fPass
);
int PassToDebuggee(
   int fPass
);

Parameters

  • fPass
    [in] Nonzero (TRUE) if the exception should be passed on to the program being debugged when execution resumes, or zero (FALSE) if the exception should be discarded.

Return Value

If successful, returns S_OK; otherwise, returns an error code.

Remarks

Calling this method does not actually cause any code to be executed in the program being debugged. The call is merely to set the state for the next code execution. For example, calls to the IDebugExceptionEvent2::CanPassToDebuggee method may return S_OK with the EXCEPTION_INFO.dwState field set to EXCEPTION_STOP_SECOND_CHANCE.

The IDE may receive the IDebugExceptionEvent2 event and call the IDebugProgram2::Continue method. The debug engine (DE) should have a default behavior to handle the case if the PassToDebuggee method is not called.

See Also

Reference

IDebugExceptionEvent2

IDebugExceptionEvent2::CanPassToDebuggee

IDebugProgram2::Continue