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

O método ReadImageNtHeaders retorna os cabeçalhos NT para a imagem especificada carregada no destino.

Sintaxe

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

Parâmetros

[in] ImageBase

Especifica o local no espaço de endereço virtual do destino da imagem cujos cabeçalhos NT estão sendo solicitados.

[out] Headers

Recebe os cabeçalhos NT para a imagem especificada.

Retornar valor

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	Nenhum cabeçalho NT foi encontrado para a imagem especificada.

 

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Comentários

Se os cabeçalhos NT da imagem forem de 32 bits, eles serão convertidos automaticamente em 64 bits para consistência. Para determinar se os cabeçalhos eram originalmente de 32 bits, examine o valor de Headers.OptionalHeader.Magic. Se o valor for IMAGE_NT_OPTIONAL_HDR32_MAGIC, os cabeçalhos NT eram originalmente de 32 bits; caso contrário, o valor é IMAGE_NT_OPTIONAL_HDR64_MAGIC, indicando que os cabeçalhos NT eram originalmente de 64 bits.

Esse método não lerá cabeçalhos ROM.

IMAGE_NT_HEADERS64, IMAGE_NT_OPTIONAL_HDR32_MAGIC e IMAGE_NT_OPTIONAL_HDR64_MAGIC aparecem no arquivo de cabeçalho SDK do Microsoft Windows winnt.h. IMAGE_NT_HEADERS64 é o equivalente a 64 bits de IMAGE_NT_HEADERS, que é descrito na documentação do SDK do Windows.

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	dbgeng.h (inclua Dbgeng.h)