Compartilhar via


Função ImageDirectoryEntryToData (dbghelp.h)

Obtém acesso a dados específicos da imagem.

Essa função foi substituída pela função ImageDirectoryEntryToDataEx . Use ImageDirectoryEntryToDataEx para recuperar o cabeçalho da seção.

Sintaxe

PVOID IMAGEAPI ImageDirectoryEntryToData(
  [in]  PVOID   Base,
  [in]  BOOLEAN MappedAsImage,
  [in]  USHORT  DirectoryEntry,
  [out] PULONG  Size
);

Parâmetros

[in] Base

O endereço base da imagem.

[in] MappedAsImage

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

[in] DirectoryEntry

O número de índice da entrada de diretório desejada. Esse parâmetro pode usar 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, em bytes.

Retornar valor

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

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

Comentários

A função ImageDirectoryEntryToData é usada para obter acesso a dados específicos da imagem.

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

ImageDirectoryEntryToDataEx

Mapviewoffile