Fungsi CheckSumMappedFile (imagehlp.h)

Artikel
02/29/2024

Menghitung checksum file gambar yang ditentukan.

Sintaks

PIMAGE_NT_HEADERS IMAGEAPI CheckSumMappedFile(
  [in]  PVOID  BaseAddress,
  [in]  DWORD  FileLength,
  [out] PDWORD HeaderSum,
  [out] PDWORD CheckSum
);

Parameter

[in] BaseAddress

Alamat dasar file yang dipetakan. Nilai ini diperoleh dengan memanggil fungsi MapViewOfFile .

[in] FileLength

Ukuran file, dalam byte.

[out] HeaderSum

Penunjuk ke variabel yang menerima checksum asli dari file gambar, atau nol jika ada kesalahan.

[out] CheckSum

Penunjuk ke variabel yang menerima checksum komputasi.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah penunjuk ke struktur IMAGE_NT_HEADERS yang terkandung dalam gambar yang dipetakan.

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

Keterangan

Fungsi CheckSumMappedFile menghitung checksum baru untuk file dan mengembalikannya dalam parameter CheckSum . Fungsi ini digunakan oleh aplikasi apa pun yang membuat atau memodifikasi gambar yang dapat dieksekusi. Checksum diperlukan untuk driver mode kernel dan beberapa DLL sistem. Linker menghitung checksum asli pada waktu tautan, jika Anda menggunakan sakelar linker yang sesuai. Untuk detail selengkapnya, lihat dokumentasi linker Anda.

Disarankan agar semua gambar memiliki checksum yang valid. Pemanggil bertanggung jawab untuk menempatkan checksum yang baru dihitung ke dalam gambar yang dipetakan dan memperbarui gambar pada disk file.

Semua fungsi ImageHlp, 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
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	imagehlp.h
Pustaka	Imagehlp.lib
DLL	Imagehlp.dll

Lihat juga

Bagikan melalui