Funzione ImageDirectoryEntryToData (dbghelp.h)

Articolo
08/23/2023

Ottiene l'accesso ai dati specifici dell'immagine.

Questa funzione è stata sostituita dalla funzione ImageDirectoryEntryToDataEx . Usare ImageDirectoryEntryToDataEx per recuperare l'intestazione della sezione.

Sintassi

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

Parametri

[in] Base

Indirizzo di base dell'immagine.

[in] MappedAsImage

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

[in] DirectoryEntry

Numero di indice della voce di directory desiderata. Questo parametro può avere 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, in byte.

Valore restituito

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

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

Commenti

La funzione ImageDirectoryEntryToData viene usata per ottenere l'accesso ai dati specifici dell'immagine.

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

ImageDirectoryEntryToDataEx

MapViewOfFile

Condividi tramite