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
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | dbghelp.h |
可再发行组件 | DbgHelp.dll 5.1 或更高版本 |