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

Статья
08/07/2023

Метод 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 или AddSymbolWideиндекс должен указывать на индекс нужного символа. Или, если индекс указывает на DEBUG_ANY_ID, символ добавляется в конец списка.

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

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

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

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

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

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