SymGetLineFromAddr 函数 (dbghelp.h)

项目
02/28/2024

查找指定地址的源行。

语法

BOOL IMAGEAPI SymGetLineFromAddr(
  [in]  HANDLE         hProcess,
  [in]  DWORD          dwAddr,
  [out] PDWORD         pdwDisplacement,
  [out] PIMAGEHLP_LINE Line
);

参数

[in] hProcess

最初传递给 SymInitialize 函数的进程句柄。

[in] dwAddr

应为其定位行的地址。地址不必位于线条边界上。如果地址出现在行的开头之后和行尾之前，则找到该行。

[out] pdwDisplacement

行开头的位移（以字节为单位），或零。

[out] Line

指向 IMAGEHLP_LINE64 结构的指针。

返回值

如果函数成功，则返回值为 TRUE。

如果函数失败，则返回值为 FALSE。若要检索扩展的错误信息，请调用 GetLastError。

注解

调用方必须在调用 SymGetLineFromAddr64 之前正确分配 Line 缓冲区并填写IMAGEHLP_LINE64结构的所需成员。

此函数返回指向另一个函数可能重复使用的缓冲区的指针。因此，请务必立即将返回的数据复制到另一个缓冲区。

所有 DbgHelp 函数（例如此函数）都是单线程的。因此，从多个线程调用此函数可能会导致意外行为或内存损坏。若要避免这种情况，必须将多个线程中的所有并发调用同步到此函数。

若要调用此函数的 Unicode 版本，请定义 DBGHELP_TRANSLATE_TCHAR。 SymGetLineFromAddrW64 在 Dbghelp.h 中定义如下。

BOOL
IMAGEAPI
SymGetLineFromAddrW64(
    _In_ HANDLE hProcess,
    _In_ DWORD64 dwAddr,
    _Out_ PDWORD pdwDisplacement,
    _Out_ PIMAGEHLP_LINEW64 Line
    );

#ifdef DBGHELP_TRANSLATE_TCHAR
 #define SymGetLineFromAddr64   SymGetLineFromAddrW64
#endif

此函数取代 SymGetLineFromAddr 函数。有关详细信息，请参阅更新的平台支持。 SymGetLineFromAddr 在 Dbghelp.h 中定义如下。

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymGetLineFromAddr SymGetLineFromAddr64
#define SymGetLineFromAddrW SymGetLineFromAddrW64
#else
BOOL
IMAGEAPI
SymGetLineFromAddr(
    _In_ HANDLE hProcess,
    _In_ DWORD dwAddr,
    _Out_ PDWORD pdwDisplacement,
    _Out_ PIMAGEHLP_LINE Line
    );

BOOL
IMAGEAPI
SymGetLineFromAddrW(
    _In_ HANDLE hProcess,
    _In_ DWORD dwAddr,
    _Out_ PDWORD pdwDisplacement,
    _Out_ PIMAGEHLP_LINEW Line
    );
#endif