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 |
---|---|
|
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. |
|
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. |
|
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 |
---|---|
|
Verwenden Sie die Standardoptionen. |
|
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 |