IDebugExceptionEvent2::PassToDebuggee
Note
This article applies to Visual Studio 2015. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here
Specifies whether the exception should be passed on to the program being debugged when execution resumes, or if the exception should be discarded.
Syntax
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 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.