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

GetLineByOffset メソッドは、ターゲット内の命令のソース ファイル内のソース ファイル名と行番号を返します。

構文

HRESULT GetLineByOffset(
  [in]            ULONG64  Offset,
  [out, optional] PULONG   Line,
  [out, optional] PSTR     FileBuffer,
  [in]            ULONG    FileBufferSize,
  [out, optional] PULONG   FileSize,
  [out, optional] PULONG64 Displacement
);

パラメーター

[in] Offset

ソース ファイルと行番号を返す命令のターゲットの仮想アドレス空間内の場所を指定します。

[out, optional] Line

Offset で指定された命令のソース ファイル内の行番号受け取ります。 行 が NULL 場合、この情報は返されません。

[out, optional] FileBuffer

Offset で指定された命令を含むファイルのファイル名受け取ります。 FileBuffer が NULL 場合、この情報は返されません。

[in] FileBufferSize

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

[out, optional] FileSize

ソース ファイル名のサイズを文字で指定します。 FileSize が NULL 場合、この情報は返されません。

[out, optional] Displacement

Offset で指定された位置と、返された行の最初の命令の位置の差を受け取ります。 ディスプレイスメント が NULL 場合、この情報は返されません。

戻り値

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

リターン コード	形容
S_OK	メソッドが成功しました。
S_FALSE	メソッドが成功しました。 ただし、バッファーはソース ファイルの名前を保持するのに十分な大きさではなく、名前が切り捨てられました。

備考

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

必要条件

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

関連項目

GetOffsetByLine の

IDebugSymbols

IDebugSymbols2 を する

IDebugSymbols3