UpdateDebugInfoFileEx 函数 (imagehlp.h)
使用指定的扩展信息更新符号文件中的相应字段。
注意 此函数适用于 .dbg 文件，而不是 .pdb 文件。
语法
BOOL IMAGEAPI UpdateDebugInfoFileEx(
[in] PCSTR ImageFileName,
[in] PCSTR SymbolPath,
[out] PSTR DebugFilePath,
[in] PIMAGE_NT_HEADERS32 NtHeaders,
[in] DWORD OldCheckSum
);
参数
[in] ImageFileName
相对于其符号文件，现在已过期的图像的名称。
[in] SymbolPath
要在其中查找符号文件的路径。
[out] DebugFilePath
指向缓冲区的指针，该缓冲区接收已更新的符号文件的名称。
[in] NtHeaders
指向指定新标头信息的 IMAGE_NT_HEADERS 结构的指针。
[in] OldCheckSum
原始校验和值。 如果此值与映射图像中存在的校验和不匹配，符号文件中的标志包含IMAGE_SEPARATE_DEBUG_MISMATCH并且最后一个错误值设置为ERROR_INVALID_DATA。
返回值
如果函数成功，则返回值为 TRUE。
如果函数失败，则返回值为 FALSE。
注解
UpdateDebugInfoFileEx 函数采用存储在 IMAGE_NT_HEADERS 结构中的信息，并更新符号文件中的相应字段。 每当修改图像文件时，应调用此函数以使数字保持同步。具体而言，每当图像校验和更改时，都应更新符号文件以匹配。
所有 ImageHlp 函数（例如此函数）都是单线程的。 因此，从多个线程调用此函数可能会导致意外行为或内存损坏。 若要避免这种情况，必须将多个线程中的所有并发调用同步到此函数。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | imagehlp.h |
| Library | Imagehlp.lib |
| DLL | Imagehlp.dll |