Função ImageDirectoryEntryToDataEx (dbghelp.h)

Artigo
03/05/2024

Localiza uma entrada de diretório dentro do cabeçalho da imagem e retorna o endereço dos dados para a entrada do diretório. Essa função retorna o cabeçalho da seção para os dados localizados, se houver um.

Sintaxe

PVOID IMAGEAPI ImageDirectoryEntryToDataEx(
  [in]            PVOID                 Base,
  [in]            BOOLEAN               MappedAsImage,
  [in]            USHORT                DirectoryEntry,
  [out]           PULONG                Size,
  [out, optional] PIMAGE_SECTION_HEADER *FoundHeader
);

Parâmetros

[in] Base

O endereço base da imagem ou do arquivo de dados.

[in] MappedAsImage

Se o sinalizador for TRUE, o arquivo será mapeado pelo sistema como uma imagem. Se esse sinalizador for FALSE, o arquivo será mapeado como um arquivo de dados pela função MapViewOfFile .

[in] DirectoryEntry

A entrada de diretório a ser localizada. O valor deve ser um dos valores a seguir.

Valor	Significado
IMAGE_DIRECTORY_ENTRY_ARCHITECTURE 7	Dados específicos da arquitetura
IMAGE_DIRECTORY_ENTRY_BASERELOC 5	Tabela de realocação base
IMAGE_DIRECTORY_ENTRY_BOUND_IMPORT 11	Diretório de importação associado
IMAGE_DIRECTORY_ENTRY_COM_DESCRIPTOR 14	Tabela de descritor COM
IMAGE_DIRECTORY_ENTRY_DEBUG 6	Diretório de depuração
IMAGE_DIRECTORY_ENTRY_DELAY_IMPORT 13	Atrasar tabela de importação
IMAGE_DIRECTORY_ENTRY_EXCEPTION 3	Diretório de exceção
IMAGE_DIRECTORY_ENTRY_EXPORT 0	Exportar diretório
IMAGE_DIRECTORY_ENTRY_GLOBALPTR 8	O endereço virtual relativo do ponteiro global
IMAGE_DIRECTORY_ENTRY_IAT 12	Importar tabela de endereços
IMAGE_DIRECTORY_ENTRY_IMPORT 1	Importar diretório
IMAGE_DIRECTORY_ENTRY_LOAD_CONFIG 10	Diretório de configuração de carga
IMAGE_DIRECTORY_ENTRY_RESOURCE 2	Diretório de recursos
IMAGE_DIRECTORY_ENTRY_SECURITY 4	Diretório de segurança
IMAGE_DIRECTORY_ENTRY_TLS 9	Diretório de armazenamento local do thread

[out] Size

Um ponteiro para uma variável que recebe o tamanho dos dados para a entrada de diretório localizada.

[out, optional] FoundHeader

Um ponteiro para uma estrutura IMAGE_SECTION_HEADER que recebe os dados. Se o cabeçalho da seção não existir, esse parâmetro será NULL.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um ponteiro para os dados da entrada de diretório.

Se a função falhar, o valor retornado será NULL. Para recuperar informações de erro estendidas, chame GetLastError.

Todas as funções DbgHelp, como esta, são threaded único. Portanto, chamadas de mais de um thread para essa função provavelmente resultarão em comportamento inesperado ou corrupção de memória. Para evitar isso, você deve sincronizar todas as chamadas simultâneas de mais de um thread para essa função.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	dbghelp.h
Biblioteca	Dbghelp.lib
DLL	Dbghelp.dll
Redistribuível	DbgHelp.dll 5.1 ou posterior

Confira também

Funções DbgHelp

IMAGE_SECTION_HEADER

Mapviewoffile

Compartilhar via