SetSystemErrorControl

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

HRESULT
  IDebugControl::SetSystemErrorControl(
    IN ULONG  OutputLevel,
    IN ULONG  BreakLevel
    );

Parameters

OutputLevel

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

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

S_OK

The method was successful.

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

Interface Version

SetSystemErrorControl is available in all versions of IDebugControl.

Comments

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

Headers: Defined in Dbgeng.h. Include Dbgeng.h.

See Also

GetSystemErrorControl, IDebugEventCallbacks::SystemError