Fungsi ImageDirectoryEntryToDataEx (dbghelp.h)

Artikel
08/23/2023

Menemukan entri direktori di dalam header gambar dan mengembalikan alamat data untuk entri direktori. Fungsi ini mengembalikan header bagian untuk data yang terletak, jika ada.

Sintaks

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

Parameter

[in] Base

Alamat dasar file gambar atau data.

[in] MappedAsImage

Jika bendera TRUE, file dipetakan oleh sistem sebagai gambar. Jika bendera ini FALSE, file dipetakan sebagai file data oleh fungsi MapViewOfFile .

[in] DirectoryEntry

Entri direktori yang akan ditemukan. Nilai harus salah satu nilai berikut.

Nilai	Makna
IMAGE_DIRECTORY_ENTRY_ARCHITECTURE 7	Data khusus arsitektur
IMAGE_DIRECTORY_ENTRY_BASERELOC 5	Tabel relokasi dasar
IMAGE_DIRECTORY_ENTRY_BOUND_IMPORT 11	Direktori impor terikat
IMAGE_DIRECTORY_ENTRY_COM_DESCRIPTOR 14	Tabel deskriptor COM
IMAGE_DIRECTORY_ENTRY_DEBUG 6	Direktori debug
IMAGE_DIRECTORY_ENTRY_DELAY_IMPORT 13	Tunda tabel impor
IMAGE_DIRECTORY_ENTRY_EXCEPTION 3	Direktori pengecualian
IMAGE_DIRECTORY_ENTRY_EXPORT 0	Ekspor direktori
IMAGE_DIRECTORY_ENTRY_GLOBALPTR 8	Alamat virtual relatif penunjuk global
IMAGE_DIRECTORY_ENTRY_IAT 12	Mengimpor tabel alamat
IMAGE_DIRECTORY_ENTRY_IMPORT 1	Impor direktori
IMAGE_DIRECTORY_ENTRY_LOAD_CONFIG 10	Memuat direktori konfigurasi
IMAGE_DIRECTORY_ENTRY_RESOURCE 2	Direktori sumber daya
IMAGE_DIRECTORY_ENTRY_SECURITY 4	Direktori keamanan
IMAGE_DIRECTORY_ENTRY_TLS 9	Direktori penyimpanan lokal utas

[out] Size

Penunjuk ke variabel yang menerima ukuran data untuk entri direktori yang berada.

[out, optional] FoundHeader

Penunjuk ke struktur IMAGE_SECTION_HEADER yang menerima data. Jika header bagian tidak ada, parameter ini adalah NULL.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah penunjuk ke data untuk entri direktori.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mengambil informasi kesalahan yang diperluas, panggil GetLastError.

Semua fungsi DbgHelp, seperti ini, adalah utas tunggal. Oleh karena itu, panggilan dari lebih dari satu utas ke fungsi ini kemungkinan akan mengakibatkan perilaku tak terduga atau kerusakan memori. Untuk menghindari hal ini, Anda harus menyinkronkan semua panggilan bersamaan dari lebih dari satu utas ke fungsi ini.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	dbghelp.h
Pustaka	Dbghelp.lib
DLL	Dbghelp.dll
Redistribusi	DbgHelp.dll 5.1 atau yang lebih baru

Lihat juga

DbgHelp Functions

IMAGE_SECTION_HEADER

MapViewOfFile

Bagikan melalui