SymSrvGetFileIndexString 函数 (dbghelp.h)
检索指定的 .pdb、.dbg 或图像文件的索引字符串。
语法
BOOL IMAGEAPI SymSrvGetFileIndexString(
[in] HANDLE hProcess,
[in, optional] PCSTR SrvPath,
[in] PCSTR File,
[out] PSTR Index,
[in] size_t Size,
[in] DWORD Flags
);
参数
[in] hProcess
进程的句柄。 此句柄必须以前传递给 SymInitialize 函数。
[in, optional] SrvPath
符号服务器的路径。
[in] File
文件的名称。
[out] Index
指向接收索引字符串的缓冲区的指针。
[in] Size
索引缓冲区的大小（以字符为单位）。
[in] Flags
此参数留待将来使用。
返回值
如果函数成功，则返回值为 TRUE。
如果函数失败，则返回值为 FALSE。 若要检索扩展的错误信息，请调用 GetLastError。
注解
此函数不一般使用。 用于管理符号服务器存储区中文件的编写实用工具可以使用此函数来预测符号服务器将查找文件的相对路径。 它由 srctool.exe 用于实际填充符号服务器存储。
所有 DbgHelp 函数（例如此函数）都是单线程的。 因此，从多个线程调用此函数可能会导致意外行为或内存损坏。 若要避免这种情况，必须将多个线程中的所有并发调用同步到此函数。
若要调用此函数的 Unicode 版本，请定义 DBGHELP_TRANSLATE_TCHAR。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | dbghelp.h |
| Library | DbgHelp.lib |
| DLL | DbgHelp.dll |
| 可再发行组件 | DbgHelp.dll 6.3 或更高版本 |