Fungsi EnumResourceLanguagesA (winbase.h)

Artikel
06/27/2024

Menghitung sumber daya khusus bahasa, dari jenis dan nama yang ditentukan, yang terkait dengan modul biner.

Sintaksis

BOOL EnumResourceLanguagesA(
  [in] HMODULE          hModule,
  [in] LPCSTR           lpType,
  [in] LPCSTR           lpName,
  [in] ENUMRESLANGPROCA lpEnumFunc,
  [in] LONG_PTR         lParam
);

Parameter

[in] hModule

Jenis: HMODULE

Handel ke modul yang akan dicari. Dimulai dengan Windows Vista, jika ini adalah Portable Executable netral bahasa (file LN), maka file .mui yang sesuai (jika ada) disertakan dalam pencarian. Jika ini adalah file .mui tertentu, hanya file tersebut yang dicari untuk sumber daya.

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 bahasanya sedang dijumlahkan. Sebagai alternatif, daripada pointer, parameter ini dapat 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] lpName

Jenis: LPCTSTR

Nama sumber daya yang bahasanya sedang dijumlahkan. Sebagai alternatif, daripada pointer, parameter ini dapat MAKEINTRESOURCE(ID), di mana ID adalah pengidentifikasi bilangan bulat sumber daya. Untuk informasi selengkapnya, lihat bagian Keterangan di bawah ini.

[in] lpEnumFunc

Jenis: ENUMRESLANGPROC

Penunjuk ke fungsi panggilan balik yang akan dipanggil untuk setiap bahasa sumber daya enumerasi. Untuk informasi selengkapnya, lihatEnumResLangProcA .

[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

Mengembalikan TRUE jika berhasil atau FALSE sebaliknya. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Jika IS_INTRESOURCE(lpType) TRUE, maka lpType 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 pound (#), maka karakter yang tersisa mewakili angka desimal yang menentukan pengidentifikasi bilangan bulat dari jenis sumber daya. Misalnya, string "#258" mewakili pengidentifikasi 258.

Demikian pula, jika IS_INTRESOURCE(lpName) TRUE, maka lpName menentukan pengidentifikasi bilangan bulat dari sumber daya yang diberikan. Jika tidak, ini adalah penunjuk ke string yang dihentikan null. Jika karakter pertama string adalah tanda pound (#), maka karakter yang tersisa mewakili angka desimal yang menentukan pengidentifikasi bilangan bulat sumber daya.

Dimulai dengan Windows Vista, modul biner biasanya merupakan Portable Executable netral bahasa (file LN), dan enumerasi juga akan menyertakan sumber daya dari file sumber daya khusus bahasa (file.mui) yang sesuai yang berisi sumber daya bahasa yang dapat dilokalkan.

Untuk setiap sumber daya yang ditemukan, EnumResourceLanguages memanggil fungsi panggilan balik yang ditentukan aplikasi lpEnumFunc, meneruskan pengidentifikasi bahasa (lihat pengidentifikasi bahasa ) bahasa tempat sumber daya ditemukan, serta berbagai parameter lain yang diteruskan ke EnumResourceLanguages.

Secara bergantian, aplikasi dapat memanggil EnumResourceLanguagesEx, yang memberikan kontrol yang lebih tepat tentang sumber daya apa yang dijumlahkan.

Fungsi EnumResourceLanguages terus menghitung bahasa sumber daya hingga fungsi panggilan balik mengembalikan FALSE atau semua bahasa sumber daya telah dijumlahkan.

Di Windows Vista dan yang lebih baru, jika hModule menentukan file LN, 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. Tidak seperti EnumResourceNames dan EnumResourceTypes, pencarian ini akan melihat beberapa file .mui. Enumerasi dimulai dengan file .mui di folder yang terkait dengan EnumUILanguages. Ini diikuti oleh file .mui lainnya yang jalurnya sesuai dengan skema yang dijelaskan di Manajemen Sumber Daya MUI. Terakhir, file yang ditunjuk oleh hModule juga dicari.

Enumerasi tidak pernah menyertakan duplikat: jika sumber daya dengan nama, jenis, dan bahasa yang sama terkandung dalam file LN dan dalam file .mui, sumber daya hanya akan dijumlahkan sekali.

Contoh

Misalnya, lihat Membuat Daftar Sumber Daya.

Nota

Header winbase.h mendefinisikan EnumResourceLanguages sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

Konseptual

EnumResLangProc

EnumResourceLanguagesEx

EnumResourceNames

EnumResourceTypes

Referensi

Sumber Daya

Bagikan melalui