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

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

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 で指定された命令のソースファイル内の行番号を受け取 ります。 Line が NULL の場合、この情報は返されません。

[out, optional] FileBuffer

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

[in] FileBufferSize

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

[out, optional] FileSize

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

[out, optional] Displacement

Offset で指定された位置と、返される行の最初の命令の位置の差を受け取ります。 Displacement が NULL の場合、この情報は返されません。

戻り値

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

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