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
接收由 文件指定的源文件中的行数。
返回值
此方法还可以返回错误值。 有关详细信息,请参阅 返回值。
返回代码 | 描述 |
---|---|
|
该方法成功。 |
|
该方法成功。 但是,源文件中的行数超过了 缓冲区 数组中的条目数,并且丢弃了某些结果。 |
言论
有关使用源路径的详细信息,请参阅 使用源文件。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |