Expand Minimize

IDebugControl::GetSystemErrorControl method

The GetSystemErrorControl method returns the control values for handling system errors.

Syntax


HRESULT GetSystemErrorControl(
  [out]  PULONG OutputLevel,
  [out]  PULONG BreakLevel
);

Parameters

OutputLevel [out]

Receives 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 [out]

Receives 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 BreakLevel, 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
IDebugEventCallbacks::SystemError
SetSystemErrorControl

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft