Compartir a través de


Función ImageDirectoryEntryToData (dbghelp.h)

Obtiene acceso a datos específicos de la imagen.

Esta función se ha reemplazado por la función ImageDirectoryEntryToDataEx . Use ImageDirectoryEntryToDataEx para recuperar el encabezado de sección.

Sintaxis

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

Parámetros

[in] Base

Dirección base de la imagen.

[in] MappedAsImage

Si este parámetro es TRUE, el sistema asigna el archivo como una imagen. Si la marca es FALSE, el archivo se asigna como un archivo de datos mediante la función MapViewOfFile .

[in] DirectoryEntry

Número de índice de la entrada de directorio deseada. Este parámetro puede 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
Cargar directorio de configuración
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, en bytes.

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.

Comentarios

La función ImageDirectoryEntryToData se usa para obtener acceso a datos específicos de la imagen.

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

ImageDirectoryEntryToDataEx

MapViewOfFile