imageDirectoryEntryToData 函数 (dbghelp.h)

获取对特定于图像的数据的访问权限。

此函数已被 ImageDirectoryEntryToDataEx 函数取代。 使用 ImageDirectoryEntryToDataEx 检索节标题。

语法

PVOID IMAGEAPI ImageDirectoryEntryToData(
  [in]  PVOID   Base,
  [in]  BOOLEAN MappedAsImage,
  [in]  USHORT  DirectoryEntry,
  [out] PULONG  Size
);

参数

[in] Base

映像的基址。

[in] MappedAsImage

如果此参数为 TRUE,则系统会将该文件映射为图像。 如果该标志为 FALSE,则 MapViewOfFile 函数会将该文件映射为数据文件。

[in] DirectoryEntry

所需目录条目的索引号。 此参数的取值可为下列值之一:

含义
IMAGE_DIRECTORY_ENTRY_ARCHITECTURE
7
特定于体系结构的数据
IMAGE_DIRECTORY_ENTRY_BASERELOC
5
基本重定位表
IMAGE_DIRECTORY_ENTRY_BOUND_IMPORT
11
绑定导入目录
IMAGE_DIRECTORY_ENTRY_COM_DESCRIPTOR
14
COM 描述符表
IMAGE_DIRECTORY_ENTRY_DEBUG
6
调试目录
IMAGE_DIRECTORY_ENTRY_DELAY_IMPORT
13
延迟导入表
IMAGE_DIRECTORY_ENTRY_EXCEPTION
3
异常目录
IMAGE_DIRECTORY_ENTRY_EXPORT
0
导出目录
IMAGE_DIRECTORY_ENTRY_GLOBALPTR
8
全局指针的相对虚拟地址
IMAGE_DIRECTORY_ENTRY_IAT
12
导入地址表
IMAGE_DIRECTORY_ENTRY_IMPORT
1
导入目录
IMAGE_DIRECTORY_ENTRY_LOAD_CONFIG
10
加载配置目录
IMAGE_DIRECTORY_ENTRY_RESOURCE
2
资源目录
IMAGE_DIRECTORY_ENTRY_SECURITY
4
安全目录
IMAGE_DIRECTORY_ENTRY_TLS
9
线程本地存储目录

[out] Size

指向一个变量的指针,该变量接收目录条目的数据大小(以字节为单位)。

返回值

如果函数成功,则返回值是指向目录条目数据的指针。

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

注解

ImageDirectoryEntryToData 函数用于获取对特定于图像的数据的访问权限。

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

要求

要求
目标平台 Windows
标头 dbghelp.h
Library Dbghelp.lib
DLL Dbghelp.dll
可再发行组件 DbgHelp.dll 5.1 或更高版本

另请参阅

DbgHelp 函数

ImageDirectoryEntryToDataEx

MapViewOfFile