Fungsi ImageLoad (imagehlp.h)

Mempertahankan daftar DLL yang dimuat.

Sintaks

PLOADED_IMAGE IMAGEAPI ImageLoad(
  [in] PCSTR DllName,
  [in] PCSTR DllPath
);

Parameter

[in] DllName

Nama gambar.

[in] DllPath

Jalur yang digunakan untuk menemukan gambar jika nama yang disediakan tidak dapat ditemukan. Jika NULL digunakan, maka aturan jalur pencarian yang ditetapkan dalam fungsi SearchPath berlaku.

Nilai kembali

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

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

Keterangan

Fungsi ImageLoad digunakan untuk mempertahankan daftar DLL yang dimuat. Jika gambar telah dimuat, LOADED_IMAGE sebelumnya dikembalikan. Jika tidak, gambar baru ditambahkan ke daftar.

Struktur LOADED_IMAGE harus dibatalkan alokasinya oleh fungsi ImageUnload .

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

ImageUnload

LOADED_IMAGE