SymFromName-Funktion (dbghelp.h)
Ruft Symbolinformationen für den angegebenen Namen ab.
Syntax
BOOL IMAGEAPI SymFromName(
[in] HANDLE hProcess,
[in] PCSTR Name,
[in, out] PSYMBOL_INFO Symbol
);
Parameter
[in] hProcess
Ein Handle für einen Prozess. Dieses Handle muss zuvor an die SymInitialize-Funktion übergeben worden sein.
[in] Name
Der Name des zu findenden Symbols.
[in, out] Symbol
Ein Zeiger auf eine SYMBOL_INFO Struktur, die Informationen zum Symbol bereitstellt.
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.
Hinweise
Alle DbgHelp-Funktionen, z. B. diese, sind singlethreaded. Daher führen an diese Funktion gerichtete Aufrufe mehrerer Threads wahrscheinlich zu unerwartetem Verhalten oder einer Beschädigung des Speichers. Um dies zu vermeiden, müssen Sie alle an diese Funktion gerichteten gleichzeitigen Aufrufe mehrerer Threads synchronisieren.
Um die Unicode-Version dieser Funktion aufzurufen, definieren Sie DBGHELP_TRANSLATE_TCHAR.
Beispiele
Ein Beispiel finden Sie unter Abrufen von Symbolinformationen nach Name.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | dbghelp.h |
| Bibliothek | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Verteilbare Komponente | DbgHelp.dll 5.1 oder höher |