mapAndLoad 函数 (imagehlp.h)

映射图像并从映射的文件预加载数据。

语法

BOOL IMAGEAPI MapAndLoad(
  [in]  PCSTR         ImageName,
  [in]  PCSTR         DllPath,
  [out] PLOADED_IMAGE LoadedImage,
  [in]  BOOL          DotDll,
  [in]  BOOL          ReadOnly
);

parameters

[in] ImageName

加载的可执行文件或 DLL) (映像的文件名。

[in] DllPath

如果找不到提供的名称,则用于查找映像的路径。 如果此参数为 NULL,则应用使用 SearchPath 函数设置的 搜索路径 规则。

[out] LoadedImage

指向 LOADED_IMAGE 结构的指针,该结构在加载图像后接收有关图像的信息。

[in] DotDll

映像名称不包含文件扩展名时要使用的默认扩展名。 如果值为 TRUE,则使用 .DLL 扩展。 如果值为 FALSE,则使用 .EXE 扩展。

[in] ReadOnly

访问模式。 如果此值为 TRUE,则仅映射文件以供只读访问。 如果值为 FALSE,则映射文件以用于读取和写入访问。

返回值

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

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

注解

MapAndLoad 函数映射图像并从映射的文件预加载数据。 必须使用相应的函数 UnMapAndLoad 解除分配 MapAndLoad 函数分配的所有资源。

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

要求

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

另请参阅

ImageHlp 函数

LOADED_IMAGE

UnMapAndLoad