Méthode IDebugDataSpaces4 ::ReadImageNtHeaders (dbgeng.h)

Article
02/26/2024

La méthode ReadImageNtHeaders retourne les en-têtes NT pour l’image spécifiée chargée dans la cible.

Syntaxe

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

Paramètres

[in] ImageBase

Spécifie l’emplacement dans l’espace d’adressage virtuel de la cible de l’image dont les en-têtes NT sont demandés.

[out] Headers

Reçoit les en-têtes NT pour l’image spécifiée.

Valeur retournée

Code de retour	Description
S_OK	La méthode a réussi.
E_INVALIDARG	Aucun en-tête NT n’a été trouvé pour l’image spécifiée.

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour .

Remarques

Si les en-têtes NT de l’image sont 32 bits, ils sont automatiquement convertis en 64 bits à des fins de cohérence. Pour déterminer si les en-têtes étaient à l’origine 32 bits, examinez la valeur Headers.OptionalHeader.Magic. Si la valeur est IMAGE_NT_OPTIONAL_HDR32_MAGIC, les en-têtes NT étaient à l’origine 32 bits ; sinon, la valeur est IMAGE_NT_OPTIONAL_HDR64_MAGIC, ce qui indique que les en-têtes NT étaient à l’origine 64 bits.

Cette méthode ne lit pas les en-têtes ROM.

IMAGE_NT_HEADERS64, IMAGE_NT_OPTIONAL_HDR32_MAGIC et IMAGE_NT_OPTIONAL_HDR64_MAGIC s’affichent dans le fichier d’en-tête Microsoft Windows SDK winnt.h. IMAGE_NT_HEADERS64 est l’équivalent 64 bits de IMAGE_NT_HEADERS, décrit dans la documentation du Kit de développement logiciel (SDK) Windows.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dbgeng.h (inclure Dbgeng.h)

Partager via