Функция ImageDirectoryEntryToDataEx (dbghelp.h)

Статья
08/23/2023

Находит запись каталога в заголовке образа и возвращает адрес данных для записи каталога. Эта функция возвращает заголовок раздела для расположенных данных, если он существует.

Синтаксис

PVOID IMAGEAPI ImageDirectoryEntryToDataEx(
  [in]            PVOID                 Base,
  [in]            BOOLEAN               MappedAsImage,
  [in]            USHORT                DirectoryEntry,
  [out]           PULONG                Size,
  [out, optional] PIMAGE_SECTION_HEADER *FoundHeader
);

Параметры

[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

Указатель на переменную, которая получает размер данных для расположенной записи каталога.

[out, optional] FoundHeader

Указатель на структуру IMAGE_SECTION_HEADER , которая получает данные. Если заголовок раздела не существует, этот параметр имеет значение NULL.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение является указателем на данные для записи каталога.

Если функция завершается сбоем, возвращается значение NULL. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.

Все функции DbgHelp, такие как эта, являются однопоточными. Таким образом, вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.

Требования

Требование	Значение
Целевая платформа	Windows
Header	dbghelp.h
Библиотека	Dbghelp.lib
DLL	Dbghelp.dll
Распространяемые компоненты	DbgHelp.dll 5.1 или более поздней версии

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

Функции DbgHelp

IMAGE_SECTION_HEADER

MapViewOfFile

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