Fungsi EnumResourceNamesA (libloaderapi.h)
Menghitung sumber daya dari jenis tertentu dalam modul biner. Untuk Windows Vista dan yang lebih baru, ini biasanya merupakan Portable Executable (file LN) yang netral bahasa, dan enumerasi juga akan mencakup sumber daya dari file sumber daya khusus bahasa (file.mui) yang sesuai yang berisi sumber daya bahasa yang dapat dilokalkan. Dimungkinkan juga bagi hModule untuk menentukan file .mui, dalam hal ini hanya file yang dicari untuk sumber daya.
Sintaks
BOOL EnumResourceNamesA(
[in, optional] HMODULE hModule,
[in] LPCSTR lpType,
[in] ENUMRESNAMEPROCA lpEnumFunc,
[in] LONG_PTR lParam
);
Parameter
[in, optional] hModule
Jenis: HMODULE
Handel ke modul yang akan dicari. Dimulai dengan Windows Vista, jika ini adalah file LN, maka file .mui yang sesuai (jika ada) disertakan dalam pencarian.
Jika parameter ini NULL, yang setara dengan meneruskan handel ke modul yang digunakan untuk membuat proses saat ini.
[in] lpType
Jenis: LPCTSTR
Jenis sumber daya yang namanya sedang dijumlahkan. Sebagai alternatif, daripada penunjuk, parameter ini dapat berupa MAKEINTRESOURCE(ID), di mana ID adalah nilai bilangan bulat yang mewakili jenis sumber daya yang telah ditentukan sebelumnya. Untuk daftar jenis sumber daya yang telah ditentukan sebelumnya, lihat Jenis Sumber Daya. Untuk informasi selengkapnya, lihat bagian Keterangan di bawah ini.
[in] lpEnumFunc
Jenis: ENUMRESNAMEPROC
Penunjuk ke fungsi panggilan balik yang akan dipanggil untuk setiap nama sumber daya atau ID yang dijumlahkan. Untuk informasi selengkapnya, lihat ENUMRESNAMEPROC.
[in] lParam
Jenis: LONG_PTR
Nilai yang ditentukan aplikasi diteruskan ke fungsi panggilan balik. Parameter ini dapat digunakan dalam pemeriksaan kesalahan.
Mengembalikan nilai
Jenis: BOOL
Nilai yang dikembalikan adalah TRUE jika fungsi berhasil atau FALSE jika fungsi tidak menemukan sumber daya dari jenis yang ditentukan, atau jika fungsi gagal karena alasan lain. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Jika IS_INTRESOURCE(lpszType) TRUE, maka lpszType menentukan pengidentifikasi bilangan bulat dari jenis sumber daya yang diberikan. Jika tidak, ini adalah penunjuk ke string yang dihentikan null. Jika karakter pertama string adalah tanda paund (#), maka karakter yang tersisa mewakili angka desimal yang menentukan pengidentifikasi bilangan bulat dari jenis sumber daya. Misalnya, string "#258" mewakili pengidentifikasi 258.
Untuk setiap sumber daya yang ditemukan, EnumResourceNames memanggil fungsi panggilan balik yang ditentukan aplikasi lpEnumFunc, meneruskan nama atau ID setiap sumber daya yang ditemukannya, serta berbagai parameter lain yang diteruskan ke EnumResourceNames.
Secara bergantian, aplikasi dapat memanggil EnumResourceNamesEx, yang memberikan kontrol yang lebih tepat tentang sumber daya apa yang dijumlahkan.
Jika sumber daya memiliki ID, ID diteruskan ke fungsi panggilan balik; jika tidak, nama sumber daya diteruskan ke fungsi panggilan balik. Untuk informasi selengkapnya, lihat ENUMRESNAMEPROC.
Fungsi EnumResourceNames terus menghitung sumber daya hingga fungsi panggilan balik mengembalikan FALSE atau semua sumber daya telah dijumlahkan.
Dimulai dengan Windows Vista, jika hModule menentukan file LN, maka sumber daya yang dijumlahkan dapat berada baik dalam file LN atau dalam file .mui yang terkait dengannya. Jika tidak ada file .mui yang ditemukan, hanya sumber daya dari file LN yang dikembalikan. Urutan di mana file .mui dicari adalah urutan pencarian Resource Loader yang biasa; lihat Manajemen Bahasa Antarmuka Pengguna untuk detailnya. Setelah satu file .mui yang sesuai ditemukan, pencarian file .mui berhenti. Karena semua file .mui yang sesuai dengan satu file LN memiliki jenis sumber daya yang sama, hanya sumber daya dalam file .mui yang ditemukan yang perlu dijumlahkan.
Enumerasi tidak pernah mencakup duplikat: jika sumber daya dengan nama yang sama terkandung dalam file LN dan dalam file .mui, sumber daya hanya akan dijumlahkan sekali.
Contoh
Misalnya, lihat Membuat Daftar Sumber Daya.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 10 Build 20348 |
| Server minimum yang didukung | Windows 10 Build 20348 |
| Header | libloaderapi.h |
| Pustaka | Kernel32.lib |
| DLL | Kernel32.dll |