Fungsi ImageRvaToVa (dbghelp.h)

Artikel
02/29/2024

Menemukan alamat virtual relatif (RVA) di dalam header gambar file yang dipetakan sebagai file dan mengembalikan alamat virtual byte yang sesuai dalam file.

Sintaks

PVOID IMAGEAPI ImageRvaToVa(
  [in]           PIMAGE_NT_HEADERS     NtHeaders,
  [in]           PVOID                 Base,
  [in]           ULONG                 Rva,
  [in, optional] PIMAGE_SECTION_HEADER *LastRvaSection
);

Parameter

[in] NtHeaders

Penunjuk ke struktur IMAGE_NT_HEADERS . Struktur ini dapat diperoleh dengan memanggil fungsi ImageNtHeader .

[in] Base

Alamat dasar gambar yang dipetakan ke dalam memori melalui panggilan ke fungsi MapViewOfFile .

[in] Rva

Alamat virtual relatif yang akan ditemukan.

[in, optional] LastRvaSection

Penunjuk ke struktur IMAGE_SECTION_HEADER yang menentukan bagian RVA terakhir. Ini adalah parameter opsional. Ketika ditentukan, menunjuk ke variabel yang berisi nilai bagian terakhir yang digunakan untuk gambar yang ditentukan untuk menerjemahkan RVA ke VA.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah alamat virtual dalam file yang dipetakan.

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

Keterangan

Fungsi ImageRvaToVa menemukan RVA dalam header gambar file yang dipetakan sebagai file dan mengembalikan alamat virtual byte yang sesuai dalam file.

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.