Freigeben über


SymEnumSymbolsEx-Funktion (dbghelp.h)

Listet alle Symbole in einem Prozess auf.

Syntax

BOOL IMAGEAPI SymEnumSymbolsEx(
  [in]           HANDLE                         hProcess,
  [in]           ULONG64                        BaseOfDll,
  [in, optional] PCSTR                          Mask,
  [in]           PSYM_ENUMERATESYMBOLS_CALLBACK EnumSymbolsCallback,
  [in, optional] PVOID                          UserContext,
  [in]           DWORD                          Options
);

Parameter

[in] hProcess

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

[in] BaseOfDll

Die Basisadresse des Moduls. Wenn dieser Wert 0 ist und Mask ein Ausrufezeichen (!) enthält, sucht die Funktion über Module hinweg. Wenn dieser Wert null ist und Mask kein Ausrufezeichen enthält, verwendet die Funktion den bereich, der von der SymSetContext-Funktion eingerichtet wurde.

[in, optional] Mask

Eine Wildcardzeichenfolge, die die Namen der zu enumerierten Symbole angibt. Der Text kann optional die Wildcards "*" und "?" enthalten.

Um ein bestimmtes Modul oder eine Bestimmte Gruppe von Modulen anzugeben, beginnen Sie den Text mit einer Wildcardzeichenfolge, 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 nach einem lokalen Symbol namens "foo" innerhalb des Bereichs, der durch den letzten Aufruf der SymSetContext-Funktion festgelegt wurde.

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. "fool" und "foot".

Wenn BaseOfDll null ist, sucht SymEnumSymbols nach einem Symbol, das mit "foo" beginnt und danach ein zusätzliches Zeichen enthält, z. B. "fool" und "foot". Die Suche würde sich innerhalb des Bereichs befinden, der durch den letzten Aufruf der SymSetContext-Funktion festgelegt wurde.

foo*!bar

SymEnumSymbols sucht in jedem geladenen Modul, das mit dem Text "foo" beginnt, nach einem Symbol namens "bar". Es könnte Übereinstimmungen wie diese finden, "foot!bar", "footlocker!bar" und "fool!bar".

*!*

SymEnumSymbols listet jedes Symbol in jedem geladenen Modul auf.

[in] EnumSymbolsCallback

Eine SymEnumSymbolsProc-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
Inlinesymbole auflisten.

Rückgabewert

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

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

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile dbghelp.h
Bibliothek DbgHelp.lib
DLL DbgHelp.dll
Verteilbare Komponente DbgHelp.dll 6.2 oder höher