BindImage 函数 (imagehlp.h)

计算每个导入函数的虚拟地址。

此函数已被 BindImageEx 函数取代。 使用 BindImageEx 提供状态例程或标志来控制映像绑定。

语法

BOOL IMAGEAPI BindImage(
  [in] PCSTR ImageName,
  [in] PCSTR DllPath,
  [in] PCSTR SymbolPath
);

parameters

[in] ImageName

要绑定的文件的名称。 此值可以是文件名、部分路径或完整路径。

[in] DllPath

如果无法打开 ImageName 参数指定的文件,则要使用的搜索路径的根目录。

[in] SymbolPath

要搜索文件的相应符号文件的路径的根。

返回值

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

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

注解

调用 BindImage 等效于以下调用: BindImageEx( 0, ImageName, DllPath, SymbolPath, NULL );

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

要求

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

另请参阅

BindImageEx

ImageHlp 函数