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


Метод IDebugDataSpaces3::ReadImageNtHeaders (dbgeng.h)

Метод ReadImageNtHeaders возвращает заголовки NT для указанного изображения, загруженного в целевой объект.

Синтаксис

HRESULT ReadImageNtHeaders(
  [in]  ULONG64             ImageBase,
  [out] PIMAGE_NT_HEADERS64 Headers
);

Параметры

[in] ImageBase

Указывает расположение в виртуальном адресном пространстве целевого образа, заголовки которого запрашиваются.

[out] Headers

Получает заголовки NT для указанного образа.

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

Код возврата Описание
S_OK
Метод выполнен успешно.
E_INVALIDARG
Заголовки NT для указанного образа не найдены.
 

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Комментарии

Если заголовки NT образа являются 32-разрядными, они автоматически преобразуются в 64-разрядные для обеспечения согласованности. Чтобы определить, были ли заголовки изначально 32-разрядными, просмотрите значение Headers.OptionalHeader.Magic. Если значение равно IMAGE_NT_OPTIONAL_HDR32_MAGIC, заголовки NT изначально были 32-разрядными; В противном случае значение равно IMAGE_NT_OPTIONAL_HDR64_MAGIC, указывая, что заголовки NT изначально были 64-разрядными.

Этот метод не считывает заголовки ПЗУ.

IMAGE_NT_HEADERS64, IMAGE_NT_OPTIONAL_HDR32_MAGIC и IMAGE_NT_OPTIONAL_HDR64_MAGIC отображаются в файле заголовка Microsoft Windows SDK winnt.h. IMAGE_NT_HEADERS64 является 64-разрядным эквивалентом IMAGE_NT_HEADERS, который описан в документации windows SDK.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h)