次の方法で共有


IDebugSymbolGroup2::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

シンボル グループ内のエントリのインデックス。 AddSymbol または AddSymbolWide を呼び出す場合、Index は目的のシンボルのインデックスを指す必要があります。 または、 Index が DEBUG_ANY_IDを指している場合は、リストの末尾に記号が追加されます。

このメソッドが返されると、 Index は シンボルの実際のインデックスを指します。 シンボルのインデックスは識別番号です。 インデックスは、0 からシンボル グループ内のシンボルの数から 1 を引いた範囲です。

戻り値

リターン コード 説明
S_OK
メソッドは正常に実行されました。
 

このメソッドは、エラー値を返すこともできます。 詳細については、「 戻り値」を参照してください。

注釈

Name のシンボル名は C++ 式エバリュエーターによって評価され、任意の C++ 式 (x+y など) を含めることができます。

必要なインデックスがシンボル グループのサイズより小さい場合は、新しいシンボルが目的のインデックスに追加されます。 目的のインデックスがシンボル グループのサイズより大きい場合、新しいシンボルがリストの末尾に追加されます (DEBUG_ANY_IDの場合と同様)。

シンボル グループの詳細については、「 スコープとシンボル グループ」を参照してください。

要件

要件
対象プラットフォーム デスクトップ
Header dbgeng.h (Dbgeng.h を含む)

こちらもご覧ください

GetNumberSymbols

IDebugSymbolGroup

IDebugSymbolGroup2

RemoveSymbolByIndex

RemoveSymbolByName