SymFromAddr 函数 (dbghelp.h)
检索指定地址的符号信息。
语法
BOOL IMAGEAPI SymFromAddr(
[in] HANDLE hProcess,
[in] DWORD64 Address,
[out, optional] PDWORD64 Displacement,
[in, out] PSYMBOL_INFO Symbol
);
参数
[in] hProcess
进程的句柄。 此句柄必须以前传递给 SymInitialize 函数。
[in] Address
符号应位于的地址。 地址不必位于符号边界上。 如果地址位于符号的开头之后和符号的末尾之前,则会找到该符号。
[out, optional] Displacement
符号开头的位移,或零。
[in, out] Symbol
指向 SYMBOL_INFO 结构的指针,该结构提供有关符号的信息。 符号名称的长度可变;因此,此缓冲区必须足够大,才能保存存储在 SYMBOL_INFO 结构末尾的名称。 请务必将 MaxNameLen 成员设置为为名称保留的字节数。
返回值
如果函数成功,则返回值为 TRUE。
如果函数失败,则返回值为 FALSE。 若要检索扩展的错误信息,请调用 GetLastError。
注解
所有 DbgHelp 函数(例如此函数)都是单线程的。 因此,从多个线程调用此函数可能会导致意外行为或内存损坏。 若要避免这种情况,必须将多个线程中的所有并发调用同步到此函数。
若要调用此函数的 Unicode 版本,请定义 DBGHELP_TRANSLATE_TCHAR。
示例
有关示例,请参阅按地址检索符号信息。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | dbghelp.h |
Library | Dbghelp.lib |
DLL | Dbghelp.dll |
可再发行组件 | DbgHelp.dll 5.1 或更高版本 |