IDebugSymbolGroup::AddSymbol 方法 (dbgeng.h)

AddSymbol 方法将符号添加到 符号组

语法

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

参数

[in] Name

符号的名称。 名称 作为表达式进行检查,以确定符号 类型。 此表达式可以包括指针、数组和结构取消引用(例如,*my_pointermy_array[1]my_struct.some_field)。

[in, out] Index

符号组中项的索引。 调用 addSymbolAddSymbolWide时,Index 应指向所需符号的索引。 或者,如果 索引 指向DEBUG_ANY_ID,则符号将追加到列表的末尾。

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

返回值

返回代码 描述
S_OK
该方法成功。
 

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

言论

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

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

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

要求

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

另请参阅

GetNumberSymbols

IDebugSymbolGroup

IDebugSymbolGroup2

RemoveSymbolByIndex

RemoveSymbolByName