Метод IDebugSymbolGroup::AddSymbol (dbgeng.h)

Статья
02/06/2025

Метод AddSymbol добавляет символ в группу символов символов.

Синтаксис

HRESULT AddSymbol(
  [in]      PCSTR  Name,
  [in, out] PULONG Index
);

Параметры

[in] Name

Имя символа. Имя рассматривается как выражение для определения типа символа. Это выражение может включать указатель, массив и расшифровку структуры (например, *my_pointer, my_array[1]или my_struct.some_field).

[in, out] Index

Индекс записи в группе символов. При вызове AddSymbol или AddSymbolWideIndex должен указывать на индекс нужного символа. Или, если индекс указывает на DEBUG_ANY_ID, символ добавляется в конец списка.

Когда этот метод возвращается, Index указывает на фактический индекс символа. Индекс символа — это идентификационный номер. Индекс диапазонов от нуля до числа символов в группе символов минус один.

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

Возвращаемый код	Описание
S_OK	Метод был успешным.

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

Замечания

Имя символа в имени вычисляется оценщиком выражений C++ и может содержать любое выражение C++ (например, x+y).

Если нужный индекс меньше размера группы символов, новый символ добавляется по нужному индексу. Если требуемый индекс больше размера группы символов, новый символ добавляется в конец списка (как в случае DEBUG_ANY_ID).

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