IDebugSymbolGroup2::AddSymbolWide 方法 (dbgeng.h)

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

语法

HRESULT AddSymbolWide(
  [in]      PCWSTR Name,
  [in, out] PULONG Index
);

参数

[in] Name

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

[in, out] Index

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

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

返回值

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

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

注解

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

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

有关符号组的详细信息,请参阅 作用域和符号组

要求

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

另请参阅

GetNumberSymbols

IDebugSymbolGroup2

RemoveSymbolByIndex

RemoveSymbolByName