Fungsi BindImageEx (imagehlp.h)

Artikel
08/24/2023

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.

Nilai	Makna
BIND_ALL_IMAGES 0x00000004	Ikat semua gambar di pohon panggilan untuk file ini.
BIND_CACHE_IMPORT_DLLS 0x00000008	Jangan buang informasi DLL dalam cache antar panggilan. Ini meningkatkan performa saat mengikat sejumlah besar gambar.
BIND_NO_BOUND_IMPORTS 0x00000001	Jangan buat tabel alamat impor baru.
BIND_NO_UPDATE 0x00000002	Jangan membuat perubahan pada file.

[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


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

ImageHlp Functions

StatusRoutine

Bagikan melalui