IDebugSymbolGroup2::GetSymbolValueText メソッド (dbgeng.h)
GetSymbolValueText メソッドは、シンボルの値を表す文字列を返します。
構文
HRESULT GetSymbolValueText(
[in] ULONG Index,
[out, optional] PSTR Buffer,
[in] ULONG BufferSize,
[out, optional] PULONG NameSize
);
パラメーター
[in] Index
値が必要なシンボルのインデックス。 シンボルのインデックスは識別番号です。 インデックスは、0 からシンボル グループ内のシンボルの数から 1 を引いた範囲です。
[out, optional] Buffer
文字列としてのシンボルの値。 Buffer が NULL の場合、この情報は返されません。
[in] BufferSize
バッファー バッファーのサイズ (文字単位)。 このサイズには、'\0' 終端文字のスペースが含まれます。
[out, optional] NameSize
記号の値のサイズ (文字単位)。 このサイズには、'\0' 終端文字のスペースが含まれます。 NameSize が NULL の場合、この情報は返されません。
戻り値
リターン コード | 説明 |
---|---|
|
メソッドは正常に実行されました。 |
|
メソッドは正常に実行されました。 ただし、シンボルの値が Buffer パラメーターによって参照されるバッファーに収まらないため、切り捨てられた値が返されました。 |
このメソッドは、エラー値を返すこともできます。 詳細については、「 戻り値」を参照してください。
注釈
AddSymbol メソッドを使用してシンボル グループにシンボルを追加した場合、Buffer に返される文字列は AddSymbol に渡されるシンボルの名前です。
シンボル グループの詳細については、「 スコープとシンボル グループ」を参照してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | dbgeng.h (Dbgeng.h を含む) |