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 或更高版本

另请参阅

DbgHelp 函数

SYMBOL_INFO