Fungsi MapDebugInformation (dbghelp.h)

Artikel
08/23/2023

Mendapatkan akses ke informasi penelusuran kesalahan untuk gambar.

Catatan Fungsi ini disediakan hanya untuk kompatibilitas mundur. Ini tidak mengembalikan informasi yang dapat diandalkan. Aplikasi baru harus menggunakan fungsi SymGetModuleInfo64 dan SymLoadModule64 .

Sintaks

PIMAGE_DEBUG_INFORMATION IMAGEAPI MapDebugInformation(
  [in, optional] HANDLE FileHandle,
  [in]           PCSTR  FileName,
  [in, optional] PCSTR  SymbolPath,
  [in]           ULONG  ImageBase
);

Parameter

[in, optional] FileHandle

Handel ke gambar yang dapat dieksekusi terbuka atau NULL.

[in] FileName

Nama file gambar yang dapat dieksekusi atau NULL.

[in, optional] SymbolPath

Jalur tempat file simbol berada. Jalur dapat berupa beberapa jalur yang dipisahkan oleh titik koma. Untuk mengambil jalur simbol, gunakan fungsi SymGetSearchPath .

[in] ImageBase

Alamat dasar untuk gambar atau nol.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah penunjuk ke struktur IMAGE_DEBUG_INFORMATION .

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

Keterangan

Fungsi MapDebugInformation digunakan untuk mendapatkan akses ke informasi penelusuran kesalahan gambar. Informasi penelusuran kesalahan diekstrak dari gambar atau file simbol dan ditempatkan ke dalam struktur IMAGE_DEBUG_INFORMATION . Struktur ini dialokasikan oleh pustaka dan harus dibatalkan alokasinya dengan menggunakan fungsi UnmapDebugInformation . Memori untuk struktur tidak dalam tumpukan default proses, jadi upaya untuk membebaskannya dengan rutinitas dealokasi memori akan gagal.

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.