Compartir a través de

Función ImageDirectoryEntryToDataEx (dbghelp.h)

  • Artículo

Busca una entrada de directorio dentro del encabezado de imagen y devuelve la dirección de los datos de la entrada de directorio. Esta función devuelve el encabezado de sección de los datos ubicados, si existe alguno.

Sintaxis

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

Dirección base del archivo de imagen o datos.

[in] MappedAsImage

Si la marca es TRUE, el sistema asigna el archivo como una imagen. Si esta marca es FALSE, la función MapViewOfFile asigna el archivo como un archivo de datos.

[in] DirectoryEntry

Entrada de directorio que se va a ubicar. El valor debe ser uno de los valores siguientes.

Valor Significado
IMAGE_DIRECTORY_ENTRY_ARCHITECTURE
7
 Datos específicos de la arquitectura
IMAGE_DIRECTORY_ENTRY_BASERELOC
5
 Tabla de reubicación base
IMAGE_DIRECTORY_ENTRY_BOUND_IMPORT
11
 Directorio de importación enlazado
IMAGE_DIRECTORY_ENTRY_COM_DESCRIPTOR
14
 Tabla de descriptores COM
IMAGE_DIRECTORY_ENTRY_DEBUG
6
 Directorio de depuración
IMAGE_DIRECTORY_ENTRY_DELAY_IMPORT
13
 Retrasar la tabla de importación
IMAGE_DIRECTORY_ENTRY_EXCEPTION
3
 Directorio de excepciones
IMAGE_DIRECTORY_ENTRY_EXPORT
0
 Exportar directorio
IMAGE_DIRECTORY_ENTRY_GLOBALPTR
8
 Dirección virtual relativa del puntero global
IMAGE_DIRECTORY_ENTRY_IAT
12
 Importar tabla de direcciones
IMAGE_DIRECTORY_ENTRY_IMPORT
1
 Importar directorio
IMAGE_DIRECTORY_ENTRY_LOAD_CONFIG
10
 Directorio de configuración de carga
IMAGE_DIRECTORY_ENTRY_RESOURCE
2
 Directorio del recurso
IMAGE_DIRECTORY_ENTRY_SECURITY
4
 Directorio de seguridad
IMAGE_DIRECTORY_ENTRY_TLS
9
 Directorio de almacenamiento local de subprocesos

[out] Size

Puntero a una variable que recibe el tamaño de los datos de la entrada de directorio que se encuentra.

[out, optional] FoundHeader

Puntero a una estructura IMAGE_SECTION_HEADER que recibe los datos. Si el encabezado de sección no existe, este parámetro es NULL.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un puntero a los datos de la entrada del directorio.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para recuperar información de error extendida, llame a GetLastError.

Todas las funciones DbgHelp, como esta, son un único subproceso. Por lo tanto, es probable que las llamadas desde más de un subproceso a esta función producirán un comportamiento inesperado o daños en la memoria. Para evitarlo, debe sincronizar todas las llamadas simultáneas de más de un subproceso a esta función.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado dbghelp.h
Library Dbghelp.lib
Archivo DLL Dbghelp.dll
Redistribuible DbgHelp.dll 5.1 o posterior

Consulte también

Funciones de DbgHelp

IMAGE_SECTION_HEADER

MapViewOfFile