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

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

[in] BufferLines

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

[out, optional] FileLines

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

返回值

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

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

注解

有关使用源路径的详细信息,请参阅 使用源文件

要求

要求
目标平台 桌面
标头 dbgeng.h (包括 Dbgeng.h)

另请参阅

FindSourceFile

GetSourceEntriesByLine

IDebugSymbols

IDebugSymbols2

IDebugSymbols3