IDebugSymbols3::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
ソース コードの行に対応するターゲットのメモリ内の場所を受け取ります。 この配列に返される最初のエントリはファイルの最初の行に対応するため、 には行 i+1
の場所がBuffer[i]
格納されます。 行に使用できるシンボル情報がない場合、 Buffer 内の対応するエントリは DEBUG_INVALID_OFFSET に設定されます。 Buffer が NULL の場合、この情報は返されません。
[in] BufferLines
Buffer 配列が保持できるPULONG64オブジェクトの数を指定します。
[out, optional] FileLines
File で指定されたソース ファイル内の行数を受け取 ります。
戻り値
このメソッドは、エラー値を返すこともできます。 詳細については、「 戻り値 」を参照してください。
リターン コード | 説明 |
---|---|
|
メソッドは正常に実行されました。 |
|
メソッドは正常に実行されました。 ただし、ソース ファイルの行数が Buffer 配列のエントリ数を超え、結果の一部が破棄されました。 |
注釈
ソース パスの使用の詳細については、「ソース ファイルの使用」を参照してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | dbgeng.h (Dbgeng.h を含む) |