UpdateDebugInfoFile 函数 (imagehlp.h)

使用指定信息更新符号文件中的相应字段。

注意 此函数适用于 .dbg 文件,而不是 .pdb 文件。
 
此函数已被 UpdateDebugInfoFileEx 函数取代。 使用 UpdateDebugInfoFileEx 验证校验和值。

语法

BOOL IMAGEAPI UpdateDebugInfoFile(
  [in]  PCSTR               ImageFileName,
  [in]  PCSTR               SymbolPath,
  [out] PSTR                DebugFilePath,
  [in]  PIMAGE_NT_HEADERS32 NtHeaders
);

参数

[in] ImageFileName

相对于其符号文件,现在已过期的图像的名称。

[in] SymbolPath

要在其中查找符号文件的路径。

[out] DebugFilePath

指向缓冲区的指针,该缓冲区接收已更新的符号文件的名称。

[in] NtHeaders

指向指定新标头信息的 IMAGE_NT_HEADERS 结构的指针。

返回值

如果函数成功,则返回值为 TRUE

如果函数失败,则返回值为 FALSE。 若要检索扩展的错误信息,请调用 GetLastError

注解

UpdateDebugInfoFile 函数采用存储在 IMAGE_NT_HEADERS 结构中的信息,并更新符号文件中的相应字段。 每当修改图像文件时,应调用此函数以使数字保持同步。具体而言,每当图像校验和更改时,都应更新符号文件以匹配。

所有 ImageHlp 函数(例如此函数)都是单线程的。 因此,从多个线程调用此函数可能会导致意外行为或内存损坏。 若要避免这种情况,必须将多个线程中的所有并发调用同步到此函数。

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 imagehlp.h
Library Imagehlp.lib
DLL Imagehlp.dll

另请参阅

IMAGE_NT_HEADERS

ImageHlp 函数

UpdateDebugInfoFileEx