IDebugSymbols::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。 如果 缓冲区NULL,则不会返回此信息。

[in] BufferLines

指定 缓冲区 数组可以容纳的PULONG64对象数。

[out, optional] FileLines

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

返回值

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

返回代码 描述
S_OK
该方法成功。
S_FALSE
该方法成功。 但是,源文件中的行数超过了 缓冲区 数组中的条目数,并且丢弃了某些结果。

言论

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

要求

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

另请参阅

FindSourceFile

GetSourceEntriesByLine

IDebugSymbols

IDebugSymbols2

IDebugSymbols3