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。
返回值
返回代码 | 说明 |
---|---|
|
方法成功。 |
此方法还可以返回错误值。 有关详细信息,请参阅 返回值。
注解
Name 中的符号名称由 C++ 表达式计算器计算,可以包含任何 C++ 表达式 (例如 x+y) 。
如果所需的索引小于符号组的大小,则会在所需索引处添加新符号。 如果所需的索引大于符号组的大小,则新符号将添加到列表末尾, (如DEBUG_ANY_ID) 的情况一样。
有关符号组的详细信息,请参阅 范围和符号组。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |