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