Edit

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.

Syntax

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 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.

See also