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

Статья
08/07/2023

Метод GetScopeSymbolGroup возвращает группу символов, содержащую символы в область текущего целевого объекта.

Синтаксис

HRESULT GetScopeSymbolGroup(
  [in]           ULONG               Flags,
  [in, optional] PDEBUG_SYMBOL_GROUP Update,
  [out]          PDEBUG_SYMBOL_GROUP *Symbols
);

Параметры

[in] Flags

Задает битовый набор, используемый для определения символов, которые следует включить в группу символов. Чтобы включить все символы, присвойте флагам значение DEBUG_SCOPE_GROUP_ALL. Следующие битовые флаги определяют, какие символы включены.

Flag	Описание
DEBUG_SCOPE_GROUP_ARGUMENTS	Включите аргументы функции для текущего область.
DEBUG_SCOPE_GROUP_LOCALS	Включите локальные переменные для текущего область.

[in, optional] Update

Указывает созданную ранее группу символов, которая будет обновлена в соответствии с текущими область. Если параметр Update имеет значение NULL, создается новый объект интерфейса группы символов.

[out] Symbols

Получает объект интерфейса группы символов для текущего область. Дополнительные сведения об этом интерфейсе см. в разделе IDebugSymbolGroup.

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

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

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

Параметр Update позволяет выполнять эффективные обновления при пошаговом выполнении кода. Вместо создания и заполнения новой группы символов можно обновить старую группу символов.

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