IDebugSymbols2::GetLineByOffset 方法 (dbgeng.h)
GetLineByOffset 方法返回目标中指令的源文件中的源文件名和行号。
语法
HRESULT GetLineByOffset(
[in] ULONG64 Offset,
[out, optional] PULONG Line,
[out, optional] PSTR FileBuffer,
[in] ULONG FileBufferSize,
[out, optional] PULONG FileSize,
[out, optional] PULONG64 Displacement
);
参数
[in] Offset
指定要返回源文件和行号的指令的目标虚拟地址空间中的位置。
[out, optional] Line
接收 由 Offset 指定的指令的源文件中的行号。 如果 Line 为 NULL,则不返回此信息。
[out, optional] FileBuffer
接收包含 Offset 指定的指令的文件的文件名。 如果 FileBuffer 为 NULL,则不返回此信息。
[in] FileBufferSize
指定 FileBuffer 缓冲区的大小(以字符为单位)。
[out, optional] FileSize
指定源文件名的大小(以字符为单位)。 如果 FileSize 为 NULL,则不返回此信息。
[out, optional] Displacement
接收 Offset 中指定的位置与返回行的第一个指令的位置之间的差异。 如果 排量 为 NULL,则不返回此信息。
返回值
此方法也可能返回其他错误值。 有关更多详细信息 ,请参阅返回值 。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
方法成功。 但是,缓冲区不够大,无法保存源文件的名称,并且名称被截断。 |
注解
有关源文件的详细信息,请参阅 使用源文件。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |