Metodo IDebugDataSpaces4::ReadImageNtHeaders (dbgeng.h)

Il metodo ReadImageNtHeaders restituisce le intestazioni NT per l'immagine specificata caricata nella destinazione.

Sintassi

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

Parametri

[in] ImageBase

Specifica il percorso nello spazio indirizzi virtuale della destinazione dell'immagine le cui intestazioni NT vengono richieste.

[out] Headers

Riceve le intestazioni NT per l'immagine specificata.

Valore restituito

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.
E_INVALIDARG	Nessuna intestazione NT trovata per l'immagine specificata.

 

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Osservazioni

Se le intestazioni NT dell'immagine sono a 32 bit, vengono convertite automaticamente in 64 bit per coerenza. Per determinare se le intestazioni erano originariamente a 32 bit, esaminare il valore di Headers.OptionalHeader.Magic. Se il valore è IMAGE_NT_OPTIONAL_HDR32_MAGIC, le intestazioni NT erano originariamente a 32 bit; in caso contrario, il valore è IMAGE_NT_OPTIONAL_HDR64_MAGIC, a indicare che le intestazioni NT erano originariamente a 64 bit.

Questo metodo non leggerà le intestazioni ROM.

IMAGE_NT_HEADERS64, IMAGE_NT_OPTIONAL_HDR32_MAGIC e IMAGE_NT_OPTIONAL_HDR64_MAGIC vengono visualizzati nel file di intestazione di Microsoft Windows SDK winnt.h. IMAGE_NT_HEADERS64 è l'equivalente a 64 bit di IMAGE_NT_HEADERS, descritto nella documentazione di Windows SDK.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	dbgeng.h (include Dbgeng.h)