PSYM_ENUMMODULES_CALLBACK回调函数 (dbghelp.h)

与 SymEnumerateModules64 函数一起使用的应用程序定义的回调函数。 它为每个枚举的模块调用一次，并接收模块信息。

PSYM_ENUMMODULES_CALLBACK64和PSYM_ENUMMODULES_CALLBACKW64类型定义指向此回调函数的指针。 SymEnumerateModulesProc64 是应用程序定义的函数名称的占位符。

语法

PSYM_ENUMMODULES_CALLBACK PsymEnummodulesCallback;

BOOL PsymEnummodulesCallback(
  [in]           PCSTR ModuleName,
  [in]           ULONG BaseOfDll,
  [in, optional] PVOID UserContext
)
{...}

参数

[in] ModuleName

模块的名称。

[in] BaseOfDll

模块加载到内存中的基址。

[in, optional] UserContext

在 SymEnumerateModules64 中指定的用户定义值，或 NULL。 通常，应用程序使用此参数来传递指向数据结构的指针，该结构允许回调函数建立某种类型的上下文。

返回值

如果返回值为 TRUE，则枚举将继续。

如果返回值为 FALSE，则枚举将停止。

注解

每个模块调用调用应用程序一次，直到枚举所有模块，或直到枚举回调函数返回 FALSE。

此回调函数取代 PSYM_ENUMMODULES_CALLBACK 回调函数。 PSYM_ENUMMODULES_CALLBACK 在 DbgHelp.h 中定义如下。

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define PSYM_ENUMMODULES_CALLBACK PSYM_ENUMMODULES_CALLBACK64
#else
typedef BOOL
(CALLBACK *PSYM_ENUMMODULES_CALLBACK)(
    __in PCSTR ModuleName,
    __in ULONG BaseOfDll,
    __in_opt PVOID UserContext
    );
#endif

要求

另请参阅

DbgHelp 函数

SymEnumerateModules64