Funzione ImageDirectoryEntryToDataEx (dbghelp.h)

Articolo
08/23/2023

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

Condividi tramite