查找符号

将符号文件加载到符号处理程序后，应用程序可以使用符号定位器函数返回指定地址的符号信息。 这些函数还可以查找地址的源代码文件名和行号位置。

枚举符号文件

若要检索模块名称加载的所有符号文件的列表，请调用 SymEnumerateModules64 函数。 有关示例，请参阅枚举符号模块。 若要检索给定模块的符号列表，请调用 SymEnumSymbols 函数。 有关示例，请参阅枚举符号。

按地址检索符号

若要检索特定地址的符号信息，请使用 SymFromAddr 函数。 此函数会检索信息并将其存储在 SYMBOL_INFO 结构中。 由于符号名称长度可变，因此必须在 SYMBOL_INFO 结构声明之后提供额外的缓冲区空间。 有关示例，请参阅按地址检索符号信息。

请注意，地址不需要位于符号边界上。 如果地址位于符号开头之后，但在符号末尾之前（符号开头加符号大小），则函数将找到此符号。

按符号名称检索符号

若要检索特定模块和符号名称的 SYMBOL_INFO 结构中的符号信息，请使用 SymFromName 函数。 如果设置了延迟的符号加载， 则 SymFromName 将尝试加载模块的符号文件（如果尚未加载）。 若要指定模块名称以及符号名称，请使用语法 Module!SymName。 "!" 字符分隔模块名称与符号名称。 有关示例，请参阅按名称检索符号信息。

按地址检索行号

若要检索特定地址的源代码位置，请使用 SymGetLineFromAddr64 函数。 此函数填充 IMAGEHLP_LINE64 结构，该结构包括指定地址引用的源文件名称和行号位置。 有关示例，请参阅按地址检索符号信息。

按符号名称检索行号

若要检索特定符号名称的源代码位置，请使用 SymGetLineFromName64 函数。 此函数类似于 SymGetSymFromName64，但检索 IMAGEHLP_LINE64 结构。 若要使用 SymGetLineFromAddr64 或 SymGetLineFromName64，则必须使用 SymSetOptions 函数设置加载行选项 (SYMOPT_LOAD_LINES)。 有关示例，请参阅按名称检索符号信息。