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 を引いた範囲です。
戻り値
リターン コード | 説明 |
---|---|
|
メソッドは正常に実行されました。 |
このメソッドは、エラー値を返すこともできます。 詳細については、「 戻り値」を参照してください。
注釈
Name のシンボル名は C++ 式エバリュエーターによって評価され、任意の C++ 式 (x+y など) を含めることができます。
必要なインデックスがシンボル グループのサイズより小さい場合は、新しいシンボルが目的のインデックスに追加されます。 目的のインデックスがシンボル グループのサイズより大きい場合、新しいシンボルがリストの末尾に追加されます (DEBUG_ANY_IDの場合と同様)。
シンボル グループの詳細については、「 スコープとシンボル グループ」を参照してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | dbgeng.h (Dbgeng.h を含む) |