Expand Minimize

IDebugControl::SetSystemErrorControl method

The SetSystemErrorControl method sets the control values for handling system errors.

Syntax


HRESULT SetSystemErrorControl(
  [in]  ULONG OutputLevel,
  [in]  ULONG BreakLevel
);

Parameters

OutputLevel [in]

Specifies the level at which system errors are printed to the engine's output. If the level of the system error is less than or equal to OutputLevel, the error is printed to the debugger console.

BreakLevel [in]

Specifies the level at which system errors break into the debugger. If the level of the system error is less than or equal to BreakLevel, the error breaks into the debugger.

Return value

This method may also return error values. See Return Values for more details.

Return codeDescription
S_OK

The method was successful.

 

Remarks

The level of a system error can take one of the following three values, listed from lowest to highest: SLE_ERROR, SLE_MINORERROR, and SLE_WARNING. These values are defined in Winuser.h.

When a system error occurs, the engine calls the IDebugEventCallbacks::SystemError method of the event callbacks. If the level is less than or equal to the BreakLevel parameter, the error will break into the debugger. If the level is greater than BreakLevel, the engine will proceed with execution in the target as indicated by the IDebugEventCallbacks::SystemError method calls. For more information about how the engine proceeds after an event, see Monitoring Events.

Requirements

Header

Dbgeng.h (include Dbgeng.h)

See also

IDebugControl
IDebugControl2
IDebugControl3
GetSystemErrorControl
IDebugEventCallbacks::SystemError

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft