检索指定名称的符号信息。
语法
BOOL IMAGEAPI SymFromNameW(
[in] HANDLE hProcess,
[in] PCWSTR Name,
[in, out] PSYMBOL_INFOW Symbol
);
参数
[in] hProcess
进程的句柄。 此句柄以前必须传递给 SymInitialize 函数。
[in] Name
要定位的符号的名称。
[in, out] Symbol
指向提供符号信息的 SYMBOL_INFO 结构的指针。
返回值
如果函数成功,则返回值 TRUE。
如果函数失败,则返回值 FALSE。 若要检索扩展的错误信息,请调用 GetLastError。
言论
所有 DbgHelp 函数(如此函数)都是单线程的。 因此,从多个线程调用此函数可能会导致意外行为或内存损坏。 若要避免这种情况,必须将来自多个线程的所有并发调用同步到此函数。
若要调用此函数的 Unicode 版本,请定义DBGHELP_TRANSLATE_TCHAR。
例子
有关示例,请参阅 按名称检索符号信息。
注意
dbghelp.h 标头将 SymFromName 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 窗户 |
| 标头 | dbghelp.h |
| 库 | Dbghelp.lib |
| DLL | Dbghelp.dll |
| 可再发行组件 | DbgHelp.dll 5.1 或更高版本 |