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

  • [アーティクル]

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

構文

HRESULT GetSourceFileLineOffsetsWide(
  [in]            PCWSTR   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に設定されます。 Buffer が NULL の場合、この情報は返されません。

[in] BufferLines

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

[out, optional] FileLines

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

戻り値

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

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

注釈

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

要件

要件 値
対象プラットフォーム デスクトップ
Header dbgeng.h (Dbgeng.h を含む)

こちらもご覧ください

FindSourceFile

GetSourceEntriesByLine

IDebugSymbols3