IDebugSymbolGroup2::AddSymbolWide メソッド (dbgeng.h)

AddSymbolWide メソッドは、シンボルグループにシンボルを追加します。

構文

HRESULT AddSymbolWide(
  [in]      PCWSTR 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の場合と同様)。

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

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