Fungsi LoadMUILibraryA (muiload.h)

Artikel
03/08/2023

Mengembalikan handel ke sumber daya khusus bahasa yang terkait dengan file language-netral (LN) tertentu.

Catatan Untuk memastikan bahwa DLL dibongkar dengan benar, aplikasi Anda harus cocok dengan setiap panggilan ke LoadMUILibrary dengan panggilan yang sesuai ke FreeMUILibrary.

Sintaks

HINSTANCE LoadMUILibraryA(
  [in] PCSTR  pszFullModuleName,
  [in] DWORD  dwLangConvention,
  [in] LANGID LangID
);

Parameter

[in] pszFullModuleName

Penunjuk ke string yang dihentikan null yang menentukan nama file LN.

[in] dwLangConvention

Bendera yang menentukan konvensi penamaan pada sistem operasi Pra-Windows Vista untuk memberi nama direktori yang berisi file sumber daya khusus bahasa. Bendera saling eksklusif, dan defaultnya adalah MUI_LANGUAGE_NAME.

Nilai	Makna
MUI_LANGUAGE_ID	Menginterpretasikan nama folder yang berisi file sumber daya khusus bahasa menggunakan format pengidentifikasi bahasa .
MUI_LANGUAGE_NAME	Menginterpretasikan nama folder yang berisi file sumber daya khusus bahasa menggunakan format nama bahasa .

Bendera berikut tersedia sebagai opsi dan dapat digunakan dalam kombinasi dengan salah satu bendera lainnya.

Nilai	Makna
MUI_LANGUAGE_EXACT	Jika sumber daya untuk bahasa yang diidentifikasi tidak ditemukan dalam file sumber daya, periksa modul utama yang ditentukan oleh pwszModuleName dan kembalikan handel ke modul tersebut jika berhasil.

[in] LangID

Pengidentifikasi bahasa untuk sumber daya antarmuka pengguna pada sistem operasi Pra-Windows Vista. Pengidentifikasi bahasa tidak dapat sesuai dengan bahasa yang terkait dengan salah satu konstanta informasi lokal ini:

Mengembalikan nilai

Mengembalikan handel ke file sumber daya khusus bahasa yang sesuai jika berhasil.

Fungsi ini mengembalikan NULL jika gagal. Untuk mendapatkan informasi kesalahan yang diperluas, aplikasi dapat memanggil GetLastError.

Keterangan

Fungsi ini memungkinkan aplikasi yang dikembangkan menggunakan teknologi sumber daya Win32 MUI untuk menentukan dengan benar file sumber daya khusus bahasa untuk dimuat pada sistem operasi Pra-Windows Vista. Aplikasi yang menggunakan fungsi ini tidak secara khusus harus dibangun di Windows Vista, tetapi mereka harus menautkan secara statis dengan pustaka MUILoad yang disediakan di Microsoft Windows SDK untuk Windows Vista. Fungsi ini mengharuskan file sumber daya yang dapat dieksekusi dan khusus bahasa disimpan menggunakan konvensi standar. Lihat Penyebaran Aplikasi untuk informasi lebih lanjut tentang penempatan file.

Item berikut memengaruhi pemuatan biner satelit oleh fungsi ini.

Versi sistem operasi yang menjalankan aplikasi yang memanggil fungsi
Bendera yang diteruskan dalam parameter dwLangConvention
Status pengidentifikasi bahasa yang diteruskan dalam parameter LangID

Saat berjalan di Windows Vista, fungsi ini memuat modul utama tanpa pengalihan. Hanya parameter pszFullModuleName yang digunakan, karena fungsi pemuat sumber daya melakukan pengalihan dengan tepat saat dipanggil. Saat berjalan pada sistem operasi Vista pra-Windows, fungsi ini memperhitungkan semua parameter yang disediakan aplikasi. Ini mengalihkan pemuatan biner ke pasangan biner satelit yang tepat yang terkait dengan file yang diwakili oleh pszFullModuleName. Proses ini menyusun ulang jalur yang terkait dengan file untuk meniru perilaku Windows Vista yang mendasar fungsi pemuat sumber daya.

Aplikasi ini menggunakan parameter dwLangConvention untuk menentukan cara biner satelit harus diselimuti. Jika aplikasi mengatur parameter ini ke MUI_LANGUAGE_ID, biner diselimuti dalam folder dengan nilai string heksadesimal. (Nilai-nilai ini tidak menyertakan 0x di depannya, dan panjangnya 4 karakter. Misalnya, en-US diwakili

sebagai "0409" dan en sebagai "0009".) Jika aplikasi mengatur parameter ke MUI_LANGUAGE_NAME, fungsi ini menggunakan pemuatan sumber daya Windows Vista, yang menggunakan pemeriksaan folder berbasis nama bahasa untuk menemukan file satelit.

Status pengidentifikasi bahasa dalam parameter LangID memengaruhi pemeriksaan sumber daya. Jika aplikasi mengatur parameter ini ke 0, fungsi menggunakan logika fallback yang telah ditentukan sebelumnya, tergantung pada sistem operasi, untuk menemukan file sumber daya khusus bahasa yang sesuai. Ketika aplikasi menetapkan LangID ke nilai bukan nol, mekanisme pemeriksaan hanya mencari folder bernama yang tepat dan setara netral terkait. Untuk informasi selengkapnya, lihat Manajemen Bahasa Antarmuka Pengguna.

LoadMUILibrary dibangun pada fungsi LoadLibraryEx, dan pertimbangan serupa perlu diterapkan pada penggunaannya. Secara khusus, FreeMUILibrary harus dipanggil untuk setiap handel yang dikembalikan oleh LoadMUILibrary. Selain itu, LoadMUILibrary tidak boleh dipanggil dari DllMain. Untuk informasi selengkapnya, lihat bagian Keterangan dari LoadLibraryEx dan FreeLibrary.

Catatan

Header muiload.h mendefinisikan LoadMUILibrary sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	muiload.h
Pustaka	Muiload.lib
Redistribusi	Muiload.lib, termasuk dalam Windows SDK untuk Windows 7 yang dapat dijalankan pada Windows 2000 Professional, Windows 2000 Server, Windows XP, Windows Server 2003, Windows Vista, Windows Server 2008, dan Windows 7.

Lihat juga

FreeMUILibrary

Antarmuka Pengguna Multibahasa

Fungsi Antarmuka Pengguna Multibahasa

Bagikan melalui