PSYM_ENUMERATESYMBOLS_CALLBACKW Rückruffunktion (dbghelp.h)

Artikel
11/20/2024

Eine anwendungsdefinierte Rückruffunktion, die mit den funktionen SymEnumSymbols, SymEnumTypesund 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_CALLBACKW PsymEnumeratesymbolsCallbackw;

BOOL PsymEnumeratesymbolsCallbackw(
  [in]           PSYMBOL_INFOW 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 Byte. Die Größe wird berechnet und ist tatsächlich eine Vermutung. In einigen Fällen kann dieser Wert null sein.

[in, optional] UserContext

Der vom SymEnumSymbols oder SymEnumTypes Funktion übergebene benutzerdefinierte Wert 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.

Rückgabewert

Wenn die Funktion TRUEzurückgibt, wird die Enumeration fortgesetzt.

Wenn die Funktion FALSE-zurückgibt, wird die Enumeration beendet.

Bemerkungen

Anmerkung

Der dbghelp.h-Header definiert PSYM_ENUMERATESYMBOLS_CALLBACK als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.