IDebugControl::SetEngineOptions method

The SetEngineOptions method changes the engine's options.

Syntax


HRESULT SetEngineOptions(
  [in] ULONG Options
);

Parameters

Options [in]

Specifies the engine's new options. Options is a bit-set; it will replace the existing symbol options. For a description of the engine options, see DEBUG_ENGOPT_XXX.

Return value

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

Return codeDescription
S_OK

The method was successful.

 

Remarks

This method will set the engine's options to those specified in Options. Unlike AddEngineOptions, any symbol options that are not listed in the Options bit-set will be removed.

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

Target platform

Header

Dbgeng.h (include Dbgeng.h)

See also

IDebugControl
IDebugControl2
IDebugControl3
AddEngineOptions
GetEngineOptions
RemoveEngineOptions

 

 

Send comments about this topic to Microsoft

Show: