IDebugDataSpaces3::ReadImageNtHeaders-Methode (dbgeng.h)

Artikel
02/27/2024

Die ReadImageNtHeaders-Methode gibt die NT-Header für das angegebene Bild zurück, das in das Ziel geladen wurde.

Syntax

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

Parameter

[in] ImageBase

Gibt den Speicherort im virtuellen Adressraum des Images an, dessen NT-Header angefordert werden.

[out] Headers

Empfängt die NT-Header für das angegebene Bild.

Rückgabewert

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_INVALIDARG	Für das angegebene Bild wurden keine NT-Header gefunden.

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .

Hinweise

Wenn die NT-Header des Bilds 32-Bit sind, werden sie aus Gründen der Konsistenz automatisch in 64-Bit konvertiert. Um zu ermitteln, ob die Header ursprünglich 32-Bit waren, sehen Sie sich den Wert von Headers.OptionalHeader.Magic an. Wenn der Wert IMAGE_NT_OPTIONAL_HDR32_MAGIC ist, waren die NT-Header ursprünglich 32 Bit; Andernfalls ist der Wert IMAGE_NT_OPTIONAL_HDR64_MAGIC, was angibt, dass die NT-Header ursprünglich 64-Bit waren.

Diese Methode liest keine ROM-Header.

IMAGE_NT_HEADERS64, IMAGE_NT_OPTIONAL_HDR32_MAGIC und IMAGE_NT_OPTIONAL_HDR64_MAGIC werden in der Microsoft Windows SDK-Headerdatei winnt.h angezeigt. IMAGE_NT_HEADERS64 ist das 64-Bit-Äquivalent von IMAGE_NT_HEADERS, das in der Windows SDK-Dokumentation beschrieben wird.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (dbgeng.h einschließen)

Freigeben über