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

接收目标内存中对应于源代码行的位置。返回到此数组的第一个条目对应于文件的第一行，因此包含 Buffer[i] 行 i+1的位置。如果行没有可用的符号信息，则 Buffer 中的相应条目设置为DEBUG_INVALID_OFFSET。如果 Buffer 为 NULL，则不返回此信息。

[in] BufferLines

指定 Buffer 数组可以容纳PULONG64个对象的数目。

[out, optional] FileLines

接收 File 指定的源文件中的行数。

返回值

此方法还可以返回错误值。有关更多详细信息，请参阅返回值。

返回代码	说明
S_OK	方法成功。
S_FALSE	方法成功。但是，源文件中的行数超过了 Buffer 数组中的条目数，并且某些结果被丢弃。