PSYM_ENUMERATESYMBOLS_CALLBACKW回呼函式（dbghelp.h）

發行項
11/20/2024

搭配 SymEnumSymbols、SymEnumTypes和 SymEnumTypesBy Name 函式使用的應用程式定義回呼函式。

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 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。