Debugging Tools for Windows

RemoveSymbolOptions

The RemoveSymbolOptions method turns off some of the engine's global symbol options.

HRESULT
  IDebugSymbols::RemoveSymbolOptions(
    IN PULONG  Options
    );

Parameters

Options
Specifies the symbol options to turn off. Options is a bit-set; the new value of the symbol options will equal the old value AND NOT the value of 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

RemoveSymbolOptions 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 it passing the DEBUG_CES_SYMBOL_OPTIONS flag to the IDebugEventCallbacks::ChangeSymbolState method.

Additional Information

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

AddSymbolOptions, GetSymbolOptions, SetSymbolOptions

Build machine: CAPEBUILD