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

[アーティクル]
02/26/2024

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

構文

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

パラメーター

[in] File

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

[out, optional] Buffer

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

[in] BufferLines

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

[out, optional] FileLines

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

戻り値

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

リターンコード	説明
S_OK	メソッドは正常に実行されました。
S_FALSE	メソッドは正常に実行されました。ただし、ソースファイルの行数が Buffer 配列のエントリ数を超え、結果の一部が破棄されました。