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.
Syntax
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 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 Continue method. The debug engine (DE) should have a default behavior to handle the case if the PassToDebuggee
method is not called.