次の方法で共有

IDebugSymbols::GetSourceFileLineOffsets メソッド (dbgeng.h)

  • [アーティクル]

GetSourceFileLineOffsets メソッドは、ソース ファイル内の各行をターゲットのメモリ内の場所にマップします。

構文

HRESULT GetSourceFileLineOffsets(
  [in]            PCSTR    File,
  [out, optional] PULONG64 Buffer,
  [in]            ULONG    BufferLines,
  [out, optional] PULONG   FileLines
);

パラメーター

[in] File

ターゲットのメモリ内の場所に行を変換するファイルの名前を指定します。 ターゲット内の各モジュールのシンボルは、このファイルに対して照会されます。 ファイルが見つからない場合は、パスが削除され、シンボルが再度照会されます。

[out, optional] Buffer

ソース コードの行に対応するターゲットのメモリ内の場所を受け取ります。 この配列に返される最初のエントリはファイルの最初の行に対応するため、Buffer[i] には行 i+1の場所が含まれます。 行に使用できるシンボル情報がない場合は、Buffer 内の対応するエントリがDEBUG_INVALID_OFFSETに設定されます。 バッファー が NULL 場合、この情報は返されません。

[in] BufferLines

Buffer 配列が保持できるPULONG64 オブジェクトの数を指定します。

[out, optional] FileLines

ファイルで指定されたソース ファイル内の行数を受け取ります。

戻り値

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

リターン コード 形容
S_OK
 メソッドが成功しました。
S_FALSE
 メソッドが成功しました。 ただし、ソース ファイル内の行数が Buffer 配列内のエントリ数を超え、結果の一部が破棄されました。

備考

ソース パスの使用方法の詳細については、「ソース ファイル の使用」を参照してください。

必要条件

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

関連項目

FindSourceFile の

GetSourceEntriesByLine を する

IDebugSymbols

IDebugSymbols2 を する

IDebugSymbols3