mapDebugInformation 函数 (dbghelp.h)

项目
02/26/2024

获取对映像调试信息的访问权限。

注意提供此函数只是为了向后兼容。它不返回可靠信息。新应用程序应使用 SymGetModuleInfo64 和 SymLoadModule64 函数。

语法

PIMAGE_DEBUG_INFORMATION IMAGEAPI MapDebugInformation(
  [in, optional] HANDLE FileHandle,
  [in]           PCSTR  FileName,
  [in, optional] PCSTR  SymbolPath,
  [in]           ULONG  ImageBase
);

参数

[in, optional] FileHandle

打开的可执行映像的句柄或 NULL。

[in] FileName

可执行映像文件的名称或 NULL。

[in, optional] SymbolPath

符号文件所在的路径。路径可以是用分号分隔的多个路径。若要检索符号路径，请使用 SymGetSearchPath 函数。

[in] ImageBase

映像的基址或零。

返回值

如果函数成功，则返回值是指向 IMAGE_DEBUG_INFORMATION 结构的指针。

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

注解

MapDebugInformation 函数用于获取对图像调试信息的访问权限。调试信息从图像或符号文件中提取并放入 IMAGE_DEBUG_INFORMATION 结构中。此结构由库分配，必须使用 UnmapDebugInformation 函数解除分配。结构的内存不在进程的默认堆中，因此尝试使用内存释放例程释放该内存将失败。

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