Fungsi UpdateDebugInfoFileEx (imagehlp.h)

Menggunakan informasi yang diperluas yang ditentukan untuk memperbarui bidang terkait dalam file simbol.

Catatan Fungsi ini berfungsi dengan file .dbg, bukan file .pdb.

 

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

Lihat juga

IMAGE_NT_HEADERS

ImageHlp Functions