SymGetLineNext 函数 (dbghelp.h)

项目
08/23/2023

检索下一个源行的行信息。

语法

BOOL IMAGEAPI SymGetLineNext(
  [in]      HANDLE         hProcess,
  [in, out] PIMAGEHLP_LINE Line
);

参数

[in] hProcess

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

[in, out] Line

指向包含行信息的 IMAGEHLP_LINE64 结构的指针。

返回值

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

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

备注

SymGetLineNext64 函数要求IMAGEHLP_LINE64结构具有有效的数据，大概是从调用 SymGetLineFromAddr64 或 SymGetLineFromName64 函数获取的。此结构按顺序接收下一行的行信息。

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

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

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


BOOL
IMAGEAPI
SymGetLineNextW64(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_LINEW64 Line

#ifdef DBGHELP_TRANSLATE_TCHAR
#define SymGetLineNext64  SymGetLineNextW64
#endif

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

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymGetLineNext SymGetLineNext64
#else
BOOL
IMAGEAPI
SymGetLineNext(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_LINE Line
    );

BOOL
IMAGEAPI
SymGetLineNextW(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_LINEW Line
    );
#endif