SymEnumSourceLines 函数 (dbghelp.h)

枚举模块中的所有源行。

语法

BOOL IMAGEAPI SymEnumSourceLines(
  [in]           HANDLE                  hProcess,
  [in]           ULONG64                 Base,
  [in, optional] PCSTR                   Obj,
  [in, optional] PCSTR                   File,
  [in, optional] DWORD                   Line,
  [in]           DWORD                   Flags,
  [in]           PSYM_ENUMLINES_CALLBACK EnumLinesCallback,
  [in, optional] PVOID                   UserContext
);

参数

[in] hProcess

进程的句柄。 此句柄以前必须传递给 SymInitialize 函数。

[in] Base

模块的基址。

[in, optional] Obj

模块中.obj文件的名称。 枚举的范围仅限于此文件。 如果此参数 NULL 或空字符串,则会搜索所有.obj文件。

[in, optional] File

一个通配符表达式,指示要搜索的源文件的名称。 如果此参数 NULL 或空字符串,则会搜索所有文件。

[in, optional] Line

模块中某行的行号。 枚举的范围仅限于此行。 如果此参数为 0,则搜索所有行。

[in] Flags

如果此参数ESLFLAG_FULLPATH,则函数与 File 参数中的完整路径匹配。

[in] EnumLinesCallback

接收行信息的 SymEnumLinesProc 回调函数。

[in, optional] UserContext

传递给回调函数的用户定义值,或 NULL。 此参数通常由应用程序用来将指针传递给提供回调函数上下文的数据结构。

返回值

如果函数成功,则返回值 TRUE

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

言论

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

要求

要求 价值
目标平台 窗户
标头 dbghelp.h
Dbghelp.lib
DLL Dbghelp.dll
可再发行组件 DbgHelp.dll 6.4 或更高版本

另请参阅

DbgHelp 函数

SymEnumLinesProc

SymInitialize