Fungsi BindImageEx (imagehlp.h)

Menghitung alamat virtual dari setiap fungsi yang diimpor.

Sintaks

BOOL IMAGEAPI BindImageEx(
  [in] DWORD                    Flags,
  [in] PCSTR                    ImageName,
  [in] PCSTR                    DllPath,
  [in] PCSTR                    SymbolPath,
  [in] PIMAGEHLP_STATUS_ROUTINE StatusRoutine
);

Parameter

[in] Flags

Opsi ikatan. Parameter ini bisa menjadi kombinasi dari nilai berikut.

[in] ImageName

Nama file yang akan diikat. Nilai ini bisa berupa nama file, jalur parsial, atau jalur lengkap.

[in] DllPath

Akar jalur pencarian yang akan digunakan jika file yang ditentukan oleh parameter ImageName tidak dapat dibuka.

[in] SymbolPath

Akar jalur untuk mencari file simbol file yang sesuai.

[in] StatusRoutine

Penunjuk ke rutinitas status. Rutinitas status dipanggil selama kemajuan pengikatan gambar. Untuk informasi selengkapnya, lihat StatusRoutine.

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

Proses pengikatan gambar terdiri dari komputasi alamat virtual dari setiap fungsi yang diimpor. Alamat virtual komputasi kemudian disimpan dalam Impor Tabel Alamat Impor (IAT) gambar. Akibatnya, gambar dimuat jauh lebih cepat, terutama jika menggunakan banyak DLL, karena pemuat sistem tidak harus menghitung alamat setiap fungsi yang diimpor.

Jika file simbol yang sesuai dapat ditemukan, stempel waktu dan checksum-nya diperbarui.

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

Lihat juga

ImageHlp Functions

StatusRoutine