次の方法で共有

IDebugAdvanced3::GetSymbolInformationWide メソッド (dbgeng.h)

  • [アーティクル]

SetSymbolInformationWide メソッドは、シンボルに関する指定された情報を返します。

構文

HRESULT GetSymbolInformationWide(
  [in]            ULONG   Which,
  [in]            ULONG64 Arg64,
  [in]            ULONG   Arg32,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  InfoSize,
  [out, optional] PWSTR   StringBuffer,
  [in]            ULONG   StringBufferSize,
  [out, optional] PULONG  StringSize
);

パラメーター

[in] Which

返す情報の一部を指定します。 次の表のいずれかの値を受け取ることができる。

価値 返される情報
DEBUG_SYMINFO_BREAKPOINT_SOURCE_LINE 指定したブレークポイントのソース コード ファイル名と行番号を返します。 行番号は、ULONG として Buffer に返されます。 ファイル名は、StringBufferに返されます。
DEBUG_SYMINFO_IMAGEHLP_MODULEW64 指定したモジュールを記述するIMAGEHLP_MODULEW64構造体を返します。 この構造の詳細については、デバッグ ヘルプ ライブラリのドキュメント (dbghelp.chm) のIMAGEHLP_MODULE64トピックを参照してください。

文字列は返されません。StringBuffer 、StringBufferSize、および StringSize を 0 に設定する必要があります。
DEBUG_SYMINFO_GET_SYMBOL_NAME_BY_OFFSET_AND_TAG_WIDE メモリ内の場所と PDB タグの種類で指定されたシンボルの Unicode 名を返します。 名前が Bufferに返されます。 StringBuffer は使用されません。
DEBUG_SYMINFO_GET_MODULE_SYMBOL_NAMES_AND_OFFSETS 指定した PDB タグの種類を持つ指定したモジュール内のシンボルのシンボル名とオフセットの一覧を返します。 オフセットは、バッファー をする ULONG 値の配列として返されます。 名前は、StringBufferへのオフセットと同じ順序で返されます。 注釈にはマルチパート名を含めることができるため、一部の名前には埋め込みゼロが含まれる場合があります。そのため、各名前は 2 つの null 文字で終了します。

[in] Arg64

64 ビット引数を指定します。 このパラメーターは、どの 値に応じて、次の解釈を行います。

DEBUG_SYMINFO_BREAKPOINT_SOURCE_LINE

無視。

DEBUG_SYMINFO_IMAGEHLP_MODULEW64

説明が要求されているモジュールのベース アドレス。

DEBUG_SYMINFO_GET_SYMBOL_NAME_BY_OFFSET_AND_TAG_WIDE

名前が要求されているシンボルのターゲットのメモリ内のアドレスを指定します。

DEBUG_SYMINFO_GET_MODULE_SYMBOL_NAMES_AND_OFFSETS

シンボルが要求されるモジュールを指定します。 Arg64 は、モジュールのメモリ割り当て内の場所です。

[in] Arg32

32 ビット引数を指定します。 このパラメーターは、どの 値に応じて、次の解釈を行います。

DEBUG_SYMINFO_BREAKPOINT_SOURCE_LINE

目的のブレークポイントのエンジン ブレークポイント ID。

DEBUG_SYMINFO_IMAGEHLP_MODULEW64

0 に設定します。

DEBUG_SYMINFO_GET_SYMBOL_NAME_BY_OFFSET_AND_TAG_WIDE

シンボルの PDB 分類。 Arg32 は、Dbghelp.h で定義されている SymTagEnum 列挙の値のいずれかである必要があります。 詳細については、PDB のドキュメントを参照してください。

DEBUG_SYMINFO_GET_MODULE_SYMBOL_NAMES_AND_OFFSETS

シンボルの PDB 分類。 Arg32 は、Dbghelp.h で定義されている SymTagEnum 列挙の値のいずれかである必要があります。 詳細については、PDB のドキュメントを参照してください。

[out, optional] Buffer

要求されたシンボル情報を受信します。 返されるデータの型は、どの の値によって異なります。 バッファー が NULL 場合、この情報は返されません。

[in] BufferSize

バッファー バッファーのサイズをバイト単位で指定します。

[out, optional] InfoSize

このメソッドが S_OKを返す場合、InfoSize は、Bufferに返されるシンボル情報のサイズ (バイト単位) を受け取ります。 このメソッドが S_FALSEを返す場合、指定されたバッファーは十分な大きさではなく、InfoSize は必要なバッファー サイズを受け取ります。 InfoSize が NULL 場合、この情報は返されません。

[out, optional] StringBuffer

要求された文字列を受信します。 この文字列の解釈は、どの 値によって異なります。 StringBuffer が NULL 場合、この情報は返されません。

[in] StringBufferSize

StringBuffer 文字列バッファーのサイズを文字数で指定します。

[out, optional] StringSize

StringBufferに返される文字列のサイズ (文字数) を受け取ります。 StringSize が NULL 場合、この情報は返されません。

戻り値

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

リターン コード 形容
S_OK
 メソッドが成功しました。
S_FALSE
 メソッドが成功しました。 ただし、情報はバッファー バッファー に収まらないか、文字列が StringBuffer バッファーに収まらないため、情報または名前が切り捨てられました。

必要条件

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