Compartir a través de


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

El método ReadImageNtHeaders devuelve los encabezados NT de la imagen especificada cargada en el destino.

Sintaxis

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

Parámetros

[in] ImageBase

Especifica la ubicación en el espacio de direcciones virtuales del destino de la imagen cuyos encabezados NT se solicitan.

[out] Headers

Recibe los encabezados NT de la imagen especificada.

Valor devuelto

Código devuelto Descripción
S_OK
Método realizado correctamente.
E_INVALIDARG
No se encontraron encabezados NT para la imagen especificada.
 

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Comentarios

Si los encabezados NT de la imagen son de 32 bits, se convierten automáticamente en 64 bits para la coherencia. Para determinar si los encabezados eran originalmente de 32 bits, examine el valor de Headers.OptionalHeader.Magic. Si el valor es IMAGE_NT_OPTIONAL_HDR32_MAGIC, los encabezados NT eran originalmente de 32 bits; de lo contrario, el valor es IMAGE_NT_OPTIONAL_HDR64_MAGIC, lo que indica que los encabezados NT fueron originalmente de 64 bits.

Este método no leerá encabezados ROM.

IMAGE_NT_HEADERS64, IMAGE_NT_OPTIONAL_HDR32_MAGIC y IMAGE_NT_OPTIONAL_HDR64_MAGIC aparecen en el archivo de encabezado Microsoft Windows SDK winnt.h. IMAGE_NT_HEADERS64 es el equivalente de 64 bits de IMAGE_NT_HEADERS, que se describe en la documentación de Windows SDK.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (include Dbgeng.h)