IDebugSymbolGroup2：：AddSymbol 方法 (dbgeng.h)

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 时， Index 应指向所需符号的索引。或者，如果 Index 指向DEBUG_ANY_ID，则符号将追加到列表末尾。

此方法返回时， Index 指向符号的实际索引。符号的索引是一个标识号。索引范围从零到符号组中的符号数减 1。

返回代码	说明
S_OK	方法成功。

此方法还可以返回错误值。有关详细信息，请参阅返回值。

Name 中的符号名称由 C++ 表达式计算器计算，可以包含任何 C++ 表达式 (例如 x+y) 。

如果所需的索引小于符号组的大小，则会在所需索引处添加新符号。如果所需的索引大于符号组的大小，则新符号将添加到列表末尾， (如DEBUG_ANY_ID) 的情况一样。

有关符号组的详细信息，请参阅范围和符号组。

要求	值
目标平台	桌面
标头	dbgeng.h (包括 Dbgeng.h)