Hitta symboler

När en symbolfil har lästs in i symbolhanteraren kan ett program använda symbollokaliserarfunktionerna för att returnera symbolinformation för en angiven adress. Dessa funktioner kan också hitta ett källkodsfilnamn och en radnummerplats för en adress.

Räkna upp symbolfiler

Om du vill hämta en lista över alla symbolfiler som läses in med modulnamnet anropar du funktionen SymEnumerateModules64. Ett exempel finns i Räkna upp symbolmoduler. Om du vill hämta en lista med symboler för en viss modul anropar du funktionen SymEnumSymbols. Ett exempel finns i Räkna upp symboler.

Hämtar symboler efter adress

Om du vill hämta symbolisk information för en specifik adress använder du funktionen SymFromAddr. Den här funktionen hämtar information och lagrar den i en SYMBOL_INFO struktur. Eftersom symbolnamnen kan variera i längd måste du ange ytterligare buffertutrymme efter SYMBOL_INFO strukturdeklarationen. Ett exempel finns i Hämta symbolinformation via adress.

Observera att adressen inte behöver vara på en symbolgräns. Om adressen kommer efter början av en symbol men före slutet av symbolen (symbolens början plus symbolstorleken) kommer funktionen att hitta symbolen.

Hämtar symboler efter symbolnamn

Om du vill hämta symbolisk information i en SYMBOL_INFO struktur för en specifik modul och symbolnamn använder du funktionen SymFromName. Om uppskjuten symbolinläsning har angetts försöker SymFromName läsa in symbolfilen för en modul om den inte redan har lästs in. Om du vill ange ett modulnamn tillsammans med ett symbolnamn använder du syntaxen Module!SymName. Tecknet "!" avgränsar modulnamnet från symbolnamnet. Ett exempel finns i Hämta symbolinformation efter namn.

Hämtar radnummer efter adress

Om du vill hämta källkodsplatsen för en specifik adress använder du funktionen SymGetLineFromAddr64. Den här funktionen fyller en IMAGEHLP_LINE64 struktur som innehåller källfilens namn och radnummerplats som anges av den angivna adressen. Ett exempel finns i Hämta symbolinformation efter adress.

Hämtar radnummer efter symbolnamn

Om du vill hämta källkodsplatsen för ett specifikt symbolnamn använder du funktionen SymGetLineFromName64. Den här funktionen liknar SymGetSymFromName64, men hämtar en IMAGEHLP_LINE64 struktur. Om du vill använda SymGetLineFromAddr64 eller SymGetLineFromName64måste du ange alternativet för belastningslinjer (SYMOPT_LOAD_LINES) med hjälp av funktionen SymSetOptions. Ett exempel finns i Hämta symbolinformation efter namn.