PSYM_ENUMERATESYMBOLS_CALLBACK Rückruffunktion (dbghelp.h)

Artikel
08/23/2023

Eine anwendungsdefinierte Rückruffunktion, die mit den Funktionen SymEnumSymbols, SymEnumTypes und SymEnumTypesByName verwendet wird.

Die Typen PSYM_ENUMERATESYMBOLS_CALLBACK und PSYM_ENUMERATESYMBOLS_CALLBACKW definieren einen Zeiger auf diese Rückruffunktion. SymEnumSymbolsProc ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

PSYM_ENUMERATESYMBOLS_CALLBACK PsymEnumeratesymbolsCallback;

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

Parameter

[in] pSymInfo

Ein Zeiger auf eine SYMBOL_INFO Struktur, die Informationen zum Symbol bereitstellt.

[in] SymbolSize

Die Größe des Symbols in Bytes. Die Größe wird berechnet und ist eigentlich eine Schätzung. In einigen Fällen kann dieser Wert null sein.

[in, optional] UserContext

Der benutzerdefinierte Wert, der von der SymEnumSymbols - oder SymEnumTypes-Funktion übergeben wird, oder NULL. Dieser Parameter wird in der Regel von einer Anwendung verwendet, um einen Zeiger an eine Datenstruktur zu übergeben, die Kontextinformationen für die Rückruffunktion bereitstellt.