Funzione ImageDirectoryEntryToDataEx (dbghelp.h)

  • Articolo

Individua una voce di directory all'interno dell'intestazione dell'immagine e restituisce l'indirizzo dei dati per la voce di directory. Questa funzione restituisce l'intestazione di sezione per i dati presenti, se esistente.

Sintassi

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

Parametri

[in] Base

Indirizzo di base dell'immagine o del file di dati.

[in] MappedAsImage

Se il flag è TRUE, il file viene mappato dal sistema come immagine. Se questo flag è FALSE, il file viene mappato come file di dati dalla funzione MapViewOfFile .

[in] DirectoryEntry

Voce di directory da individuare. Il valore deve essere uno dei valori seguenti.

Valore Significato
IMAGE_DIRECTORY_ENTRY_ARCHITECTURE
7
 Dati specifici dell'architettura
IMAGE_DIRECTORY_ENTRY_BASERELOC
5
 Tabella di rilocazione di base
IMAGE_DIRECTORY_ENTRY_BOUND_IMPORT
11
 Directory di importazione associata
IMAGE_DIRECTORY_ENTRY_COM_DESCRIPTOR
14
 Tabella del descrittore COM
IMAGE_DIRECTORY_ENTRY_DEBUG
6
 Directory di debug
IMAGE_DIRECTORY_ENTRY_DELAY_IMPORT
13
 Tabella di importazione ritardata
IMAGE_DIRECTORY_ENTRY_EXCEPTION
3
 Directory eccezioni
IMAGE_DIRECTORY_ENTRY_EXPORT
0
 Esporta directory
IMAGE_DIRECTORY_ENTRY_GLOBALPTR
8
 Indirizzo virtuale relativo del puntatore globale
IMAGE_DIRECTORY_ENTRY_IAT
12
 Importare la tabella degli indirizzi
IMAGE_DIRECTORY_ENTRY_IMPORT
1
 Importa directory
IMAGE_DIRECTORY_ENTRY_LOAD_CONFIG
10
 Caricare la directory di configurazione
IMAGE_DIRECTORY_ENTRY_RESOURCE
2
 Directory delle risorse
IMAGE_DIRECTORY_ENTRY_SECURITY
4
 Directory di sicurezza
IMAGE_DIRECTORY_ENTRY_TLS
9
 Directory di archiviazione locale thread

[out] Size

Puntatore a una variabile che riceve le dimensioni dei dati per la voce di directory che si trova.

[out, optional] FoundHeader

Puntatore a una struttura IMAGE_SECTION_HEADER che riceve i dati. Se l'intestazione di sezione non esiste, questo parametro è NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un puntatore ai dati per la voce di directory.

Se la funzione ha esito negativo, il valore restituito è NULL. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Di conseguenza, le chiamate da più thread a questa funzione genereranno un comportamento imprevisto o un danneggiamento della memoria. Per evitare questo problema, è necessario sincronizzare tutte le chiamate simultanee da più thread a questa funzione.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione dbghelp.h
Libreria Dbghelp.lib
DLL Dbghelp.dll
Componente ridistribuibile DbgHelp.dll 5.1 o versione successiva

Vedi anche

Funzioni DbgHelp

IMAGE_SECTION_HEADER

MapViewOfFile