IDebugSymbols：：GetSourceFileLineOffsets 方法 (dbgeng.h)

项目
08/07/2023

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 数组中的条目数，并且某些结果被丢弃。