次の方法で共有


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

GetSymbolValueTextWide メソッドは、シンボルの値を表す文字列を返します。

構文

HRESULT GetSymbolValueTextWide(
  [in]            ULONG  Index,
  [out, optional] PWSTR  Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG NameSize
);

パラメーター

[in] Index

値が必要なシンボルのインデックス。 シンボルのインデックスは識別番号です。 インデックスの範囲は、0 からシンボル グループ内のシンボルの数から 1 を引いた値までです。

[out, optional] Buffer

文字列としてのシンボルの値。 バッファー が NULL 場合、この情報は返されません。

[in] BufferSize

Buffer バッファーのサイズ (文字数)。 このサイズには、'\0' 終端文字のスペースが含まれます。

[out, optional] NameSize

シンボルの値のサイズ (文字単位)。 このサイズには、'\0' 終端文字のスペースが含まれます。 NameSize が NULL 場合、この情報は返されません。

戻り値

リターン コード 形容
S_OK
メソッドが成功しました。
S_FALSE
メソッドが成功しました。 ただし、シンボルの値は、Buffer パラメーターによって参照されるバッファーに収まらないため、切り捨てられた値が返されました。
 

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

備考

AddSymbol メソッドを使用してシンボル グループにシンボルを追加した場合、Buffer に返される文字列は、AddSymbolに渡されるシンボルの名前です。

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

必要条件

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

関連項目

GetNumberSymbols

IDebugSymbolGroup2

WriteSymbol