SymEnumSourceFiles 函数 (dbghelp.h)

枚举进程中的所有源文件。

语法

BOOL IMAGEAPI SymEnumSourceFiles(
  [in]           HANDLE                        hProcess,
  [in]           ULONG64                       ModBase,
  [in, optional] PCSTR                         Mask,
  [in]           PSYM_ENUMSOURCEFILES_CALLBACK cbSrcFiles,
  [in, optional] PVOID                         UserContext
);

参数

[in] hProcess

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

[in] ModBase

模块的基址。 如果此值为零,并且 Mask 包含感叹号 (!) ,则函数将跨模块进行查找。 如果此值为零并且 Mask 不包含感叹号,则函数将使用 SymSetContext 函数建立的范围。

[in, optional] Mask

一个通配符表达式,指示要枚举的源文件的名称。 若要指定模块名称,请使用 !mod 语法。

如果此参数为 NULL,则该函数将枚举所有文件。

[in] cbSrcFiles

指向接收源文件信息的 SymEnumSourceFilesProc 回调函数的指针。

[in, optional] UserContext

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

返回值

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

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

注解

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

要求

要求
目标平台 Windows
标头 dbghelp.h
Library Dbghelp.lib
DLL Dbghelp.dll
可再发行组件 DbgHelp.dll 6.2 或更高版本

另请参阅

DbgHelp 函数

SymEnumSourceFilesProc