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

Статья
02/23/2024

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

Синтаксис

HRESULT GetScopeSymbolGroup2(
  [in]           ULONG                Flags,
  [in, optional] PDEBUG_SYMBOL_GROUP2 Update,
  [out]          PDEBUG_SYMBOL_GROUP2 *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 позволяет выполнять эффективные обновления при пошаговом выполнении кода. Вместо создания и заполнения новой группы символов можно обновить старую группу символов.

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