Fungsi UpdateDebugInfoFileEx (imagehlp.h)
Menggunakan informasi yang diperluas yang ditentukan untuk memperbarui bidang terkait dalam file simbol.
Sintaks
BOOL IMAGEAPI UpdateDebugInfoFileEx(
[in] PCSTR ImageFileName,
[in] PCSTR SymbolPath,
[out] PSTR DebugFilePath,
[in] PIMAGE_NT_HEADERS32 NtHeaders,
[in] DWORD OldCheckSum
);
Parameter
[in] ImageFileName
Nama gambar yang sekarang sudah kedaluarsa sehubungan dengan file simbolnya.
[in] SymbolPath
Jalur untuk mencari file simbol.
[out] DebugFilePath
Penunjuk ke buffer yang menerima nama file simbol yang diperbarui.
[in] NtHeaders
Penunjuk ke struktur IMAGE_NT_HEADERS yang menentukan informasi header baru.
[in] OldCheckSum
Nilai checksum asli. Jika nilai ini tidak cocok dengan checksum yang ada dalam gambar yang dipetakan, bendera dalam file simbol berisi IMAGE_SEPARATE_DEBUG_MISMATCH dan nilai kesalahan terakhir diatur ke ERROR_INVALID_DATA.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE.
Jika fungsi gagal, nilai yang dikembalikan adalah FALSE.
Keterangan
Fungsi UpdateDebugInfoFileEx mengambil informasi yang disimpan dalam struktur IMAGE_NT_HEADERS dan memperbarui bidang yang sesuai dalam file simbol. Setiap kali file gambar dimodifikasi, fungsi ini harus dipanggil untuk menjaga angka tetap sinkron. Secara khusus, setiap kali checksum gambar berubah, file simbol harus diperbarui agar cocok.
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 |