Поделиться через

Функция 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
Header dbghelp.h
Библиотека Dbghelp.lib
DLL Dbghelp.dll
Распространяемые компоненты DbgHelp.dll 5.1 или более поздней версии

См. также раздел

Функции DbgHelp

ImageDirectoryEntryToDataEx

MapViewOfFile