Метод IDebugSymbols3::SetSymbolOptions (dbgeng.h)

Статья
08/07/2023

Метод SetSymbolOptions изменяет параметры глобальных символов подсистемы.

Синтаксис

HRESULT SetSymbolOptions(
  [in] ULONG Options
);

Параметры

[in] Options

Задает новые параметры символов. Параметры задаются битами; он заменит существующие параметры символов. Описание битовых флагов см. в разделе Настройка параметров символов.

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Код возврата	Описание
S_OK	Метод выполнен успешно.

Этот метод задает для глобальных параметров символов подсистемы значения, указанные в разделе Параметры. В отличие от AddSymbolOptions, все параметры символов, отсутствуют в параметрах битового набора, будут удалены.

После изменения параметров символов для каждого клиента подсистема отправляет уведомление в IDebugEventCallbacks этого клиента, передав флаг DEBUG_CES_SYMBOL_OPTIONS методу IDebugEventCallbacks::ChangeSymbolState .

Дополнительные сведения о символах см. в разделе Символы.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	dbgeng.h (включая Dbgeng.h, Dbghelp.h)