IDebugExceptionEvent2::PassToDebuggee

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. 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.

See also