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 會指向符號的實際索引。符號的索引是標識碼。索引的範圍從零到符號群組中的符號數目減一。

傳回碼	描述
S_OK	此方法成功。

這個方法也可以傳回錯誤值。如需詳細資訊，請參閱傳回值。

Name 中的符號名稱是由 C++ 運算式評估工具評估，而且可以包含任何 C++ 運算式 (，例如 x+y) 。

如果您想要的索引小於符號群組的大小，則會在所需的索引處新增新的符號。如果所需的索引大於符號群組的大小，則新的符號會新增至清單結尾 (，如同DEBUG_ANY_ID) 。

如需符號群組的詳細資訊，請參閱範圍和符號群組。

需求	值
目標平台	桌面
標頭	dbgeng.h (包含 Dbgeng.h)