SymGetLineFromName 函数是 Win32 调试帮助库(DbgHelp)中的一部分,用于根据源文件名和行号获取源代码行信息。

以下是该函数的声明:
BOOL SymGetLineFromName(
  HANDLE           hProcess,
  PCSTR            ModuleName,
  PCSTR            FileName,
  DWORD            dwLineNumber,
  PLONG            plDisplacement,
  PIMAGEHLP_LINE   Line
);

参数说明:

  •  hProcess:目标进程的句柄。通常,可以使用 GetCurrentProcess() 来获取当前进程的句柄。

  •  ModuleName:模块名或者模块的基本地址。可以为 NULL。

  •  FileName:源文件名。如果为 NULL,将会忽略文件名条件。

  •  dwLineNumber:行号。如果为 0,将会忽略行号条件。

  •  plDisplacement:返回指定条件与找到的源代码行的偏移量。

  •  Line:指向 IMAGEHLP_LINE 结构的指针,该结构包含了找到的源代码行的信息。


函数返回值为 TRUE 表示成功,FALSE 表示失败。

以下是一个简单的示例:
#include <windows.h>
#include <dbghelp.h>
#include <stdio.h>

int main() {
    HANDLE hProcess = GetCurrentProcess();
    const char* moduleName = NULL; // 替换为实际的模块名或基地址
    const char* fileName = "example.cpp"; // 替换为实际的文件名
    DWORD lineNumber = 42; // 替换为实际的行号

    // 初始化符号引擎
    SymInitialize(hProcess, NULL, TRUE);

    IMAGEHLP_LINE lineInfo = { sizeof(IMAGEHLP_LINE) };
    LONG displacement;

    // 获取源代码行信息
    BOOL success = SymGetLineFromName(
        hProcess, moduleName, fileName, lineNumber, &displacement, &lineInfo);

    if (success) {
        printf("Source code information for %s:%u:\n", fileName, lineNumber);
        printf("File: %s\n", lineInfo.FileName);
        printf("Line: %u\n", lineInfo.LineNumber);
        printf("Displacement: %u bytes\n", displacement);
    } else {
        printf("Failed to retrieve source code information.\n");
    }

    // 清理符号引擎
    SymCleanup(hProcess);

    return 0;
}

请注意,为了使用这些函数,你需要链接 dbghelp.lib 库,并且在编译时确保 dbghelp.dll 可以在运行时找到。


转载请注明出处:http://www.zyzy.cn/article/detail/26321/Win32 API/Dbghelp.h/SymGetLineFromName