AddSymbolOptions

The AddSymbolOptions method turns on some of the engine's global symbol options.

HRESULT
  IDebugSymbols::AddSymbolOptions(
    IN PULONG  Options
    );

Parameters

Options

Specifies the symbol options to turns on. Options is a bit-set that will be ORed with the existing symbol options. For a description of the bit flags, see Setting Symbol Options.

Return Value

S_OK

The method was successful.

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

Interface Version

AddSymbolOptions is available in all versions of IDebugSymbols.

Comments

After the symbol options have been changed, for each client the engine sends out notification to that client's IDebugEventCallbacks by passing the DEBUG_CES_SYMBOL_OPTIONS flag to the IDebugEventCallbacks::ChangeSymbolState method.

For more information about symbols, see Symbols.

Requirements

Headers: Defined in Dbgeng.h. Include Dbgeng.h. The options are defined in Dbghelp.h.

See Also

GetSymbolOptions, RemoveSymbolOptions, SetSymbolOptions