PSYM_ENUMERATESYMBOLS_CALLBACKW回调函数 (dbghelp.h)

项目
02/29/2024

与 SymEnumSymbols、 SymEnumTypes 和 SymEnumTypesByName 函数一起使用的应用程序定义的回调函数。

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

语法

PSYM_ENUMERATESYMBOLS_CALLBACKW PsymEnumeratesymbolsCallbackw;

BOOL PsymEnumeratesymbolsCallbackw(
  [in]           PSYMBOL_INFOW pSymInfo,
  [in]           ULONG SymbolSize,
  [in, optional] PVOID UserContext
)
{...}

参数

[in] pSymInfo

指向 SYMBOL_INFO 结构的指针，该结构提供有关符号的信息。

[in] SymbolSize

符号的大小（以字节为单位）。大小是计算的，实际上是一个猜测。在某些情况下，此值可以为零。

[in, optional] UserContext

从 SymEnumSymbols 或 SymEnumTypes 函数传递的用户定义值，或 NULL。此参数通常由应用程序用于传递指向为回调函数提供上下文信息的数据结构的指针。

返回值

如果函数返回 TRUE，则枚举将继续。

如果函数返回 FALSE，则枚举将停止。

注解

注意

dbghelp.h 标头将PSYM_ENUMERATESYMBOLS_CALLBACK定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。