IDebugControl3::AddEngineOptions method (dbgeng.h)

Article
02/22/2024

The AddEngineOptions method turns on some of the debugger engine's options.

Syntax

HRESULT AddEngineOptions(
  [in] ULONG Options
);

Parameters

[in] Options

Specifies engine options to turn on. Options is a bit-set that will be combined with the existing engine options using the bitwise-OR operator. For a description of the engine options, see DEBUG_ENGOPT_XXX.

Return value

Return code	Description
S_OK	The method was successful.

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

Remarks

After the engine options have been changed, the engine sends out notification to each client's event callback object by passing the DEBUG_CES_ENGINE_OPTIONS flag to the IDebugEventCallbacks::ChangeEngineState method.

Requirements

Requirement	Value
Target Platform	Desktop
Header	dbgeng.h (include Dbgeng.h)