Fungsi UpdateDebugInfoFile (imagehlp.h)

Artikel
02/26/2024

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

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

Fungsi ini telah digantikan oleh fungsi UpdateDebugInfoFileEx . Gunakan UpdateDebugInfoFileEx untuk memverifikasi nilai checksum.

Sintaks

BOOL IMAGEAPI UpdateDebugInfoFile(
  [in]  PCSTR               ImageFileName,
  [in]  PCSTR               SymbolPath,
  [out] PSTR                DebugFilePath,
  [in]  PIMAGE_NT_HEADERS32 NtHeaders
);

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.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE.

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

Keterangan

Fungsi UpdateDebugInfoFile 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

UpdateDebugInfoFileEx

Bagikan melalui