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 |