次の方法で共有

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 はシンボルの実際のインデックスを指します。 シンボルのインデックスは識別番号です。 インデックスの範囲は、0 からシンボル グループ内のシンボルの数から 1 を引いた値までです。

戻り値

リターン コード 形容
S_OK
 メソッドが成功しました。
 

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

備考

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

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

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

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー dbgeng.h (Dbgeng.h を含む)

関連項目

GetNumberSymbols の

IDebugSymbolGroup の

IDebugSymbolGroup2 の

RemoveSymbolByIndex の

RemoveSymbolByName の