SymEnumSymbolsExW-Funktion (dbghelp.h)

Artikel
11/20/2024

Listet alle Symbole in einem Prozess auf.

Syntax

BOOL IMAGEAPI SymEnumSymbolsExW(
  [in]           HANDLE                          hProcess,
  [in]           ULONG64                         BaseOfDll,
  [in, optional] PCWSTR                          Mask,
  [in]           PSYM_ENUMERATESYMBOLS_CALLBACKW EnumSymbolsCallback,
  [in, optional] PVOID                           UserContext,
  [in]           DWORD                           Options
);

Parameter

[in] hProcess

Ein Handle für einen Prozess. Dieser Handle muss zuvor an die SymInitialize Funktion übergeben worden sein.

[in] BaseOfDll

Die Basisadresse des Moduls. Wenn dieser Wert null ist und Mask ein Ausrufezeichen (!)enthält, sieht die Funktion über Module hinweg. Wenn dieser Wert null ist und Mask- kein Ausrufezeichen enthält, verwendet die Funktion den Bereich, der durch die SymSetContext-funktion festgelegt wurde.

[in, optional] Mask

Eine Wildcardzeichenfolge, die die Namen der symbole angibt, die aufgezählt werden sollen. Der Text kann optional die Wildcards "*" und "?" enthalten.

Um ein bestimmtes Modul oder eine Gruppe von Modulen anzugeben, beginnen Sie den Text mit einer Platzhalterzeichenfolge, die das Modul angibt, gefolgt von einem Ausrufezeichen. Beim Angeben eines Moduls wird BaseOfDll- ignoriert.

Wert	Bedeutung
foo	Wenn BaseOfDll- nicht null ist, sucht SymEnumSymbols- nach einem globalen Symbol namens "foo". Wenn BaseOfDll- null ist, sucht SymEnumSymbols- innerhalb des Bereichs, der durch den letzten Aufruf der SymSetContext- funktion eingerichtet wurde, nach einem lokalen Symbol namens "foo".
foo?	Wenn BaseOfDll nicht null ist, sucht SymEnumSymbols nach einem globalen Symbol, das mit "foo" beginnt und danach ein zusätzliches Zeichen enthält, z. B. "Narr" und "Fuß". Wenn BaseOfDll null ist, sucht SymEnumSymbols nach einem Symbol, das mit "foo" beginnt und danach ein zusätzliches Zeichen enthält, z. B. "Narr" und "Fuß". Die Suche würde sich innerhalb des Bereichs befinden, der durch den letzten Aufruf der SymSetContext--Funktion eingerichtet wurde.
*foo!bar**	SymEnumSymbols- werden in jedem geladenen Modul angezeigt, das mit dem Text "foo" für ein Symbol namens "bar" beginnt. Es könnte Übereinstimmungen wie diese finden, "foot!bar", "footlocker!bar" und "nar!bar".
*!*	SymEnumSymbols alle Symbole in jedem geladenen Modul aufzählen.

[in] EnumSymbolsCallback

Eine SymEnumSymbolsProcW Rückruffunktion, die die Symbolinformationen empfängt.

[in, optional] UserContext

Ein benutzerdefinierter Wert, der an die Rückruffunktion übergeben wird, oder NULL-. Dieser Parameter wird in der Regel von einer Anwendung verwendet, um einen Zeiger an eine Datenstruktur zu übergeben, die Kontext für die Rückruffunktion bereitstellt.

[in] Options

Gibt mögliche Optionen an.

Wert	Bedeutung
SYMENUM_OPTIONS_DEFAULT 1	Verwenden Sie die Standardoptionen.
SYMENUM_OPTIONS_INLINE 2	Aufzählen von Inlinesymbolen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen abzurufen.

Bemerkungen

Anmerkung

Der dbghelp.h-Header definiert SymEnumSymbolsEx 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.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	dbghelp.h
Library	DbgHelp.lib
DLL-	DbgHelp.dll
redistributable	DbgHelp.dll 6.2 oder höher

Freigeben über