Fungsi FindResourceExA (winbase.h)
Menentukan lokasi sumber daya dengan jenis, nama, dan bahasa yang ditentukan dalam modul yang ditentukan.
Sintaks
HRSRC FindResourceExA(
[in, optional] HMODULE hModule,
[in] LPCSTR lpType,
[in] LPCSTR lpName,
[in] WORD wLanguage
);
Parameter
[in, optional] hModule
Jenis: HMODULE
Handel ke modul yang file portabelnya dapat dieksekusi atau file MUI yang menyertainya berisi sumber daya. Jika parameter ini NULL, fungsi mencari modul yang digunakan untuk membuat proses saat ini.
[in] lpType
Jenis: LPCTSTR
Jenis sumber daya. Sebagai alternatif, daripada penunjuk, parameter ini dapat berupa MAKEINTRESOURCE(ID), di mana ID adalah pengidentifikasi bilangan bulat dari yang diberikan
jenis sumber daya. Untuk jenis sumber daya standar, lihat Jenis Sumber Daya. Untuk informasi selengkapnya, lihat bagian Keterangan di bawah ini.
[in] lpName
Jenis: LPCTSTR
Nama sumber daya. Sebagai alternatif, daripada penunjuk, parameter ini dapat berupa MAKEINTRESOURCE(ID), di mana ID adalah pengidentifikasi bilangan bulat sumber daya. Untuk informasi selengkapnya, lihat bagian Keterangan di bawah ini.
[in] wLanguage
Ketik: WORD
Bahasa sumber daya. Jika parameter ini adalah MAKELANGID(LANG_NEUTRAL, SUBLANG_NEUTRAL)
, bahasa saat ini yang terkait dengan utas panggilan digunakan.
Untuk menentukan bahasa selain bahasa saat ini, gunakan makro MAKELANGID untuk membuat parameter ini. Untuk informasi selengkapnya, lihat MAKELANGID.
Mengembalikan nilai
Jenis: HRSRC
Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke blok informasi sumber daya yang ditentukan. Untuk mendapatkan handel ke sumber daya, teruskan handel ini ke fungsi LoadResource .
Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Jika IS_INTRESOURCETRUE untuk x = lpType atau lpName, x menentukan pengidentifikasi bilangan bulat dari jenis atau nama sumber daya yang diberikan. Jika tidak, parameter tersebut adalah penunjuk panjang ke string yang dihentikan null. Jika karakter pertama string adalah tanda paund (#), karakter yang tersisa mewakili angka desimal yang menentukan pengidentifikasi bilangan bulat dari nama atau jenis sumber daya. Misalnya, string "#258" mewakili pengidentifikasi bilangan bulat 258.
Untuk mengurangi jumlah memori yang diperlukan untuk sumber daya, aplikasi harus merujuknya dengan pengidentifikasi bilangan bulat alih-alih berdasarkan nama.
Aplikasi dapat menggunakan FindResourceEx untuk menemukan semua jenis sumber daya, tetapi fungsi ini harus digunakan hanya jika aplikasi harus mengakses data sumber daya biner dengan melakukan panggilan berikutnya ke LoadResource lalu ke LockResource.
Untuk segera menggunakan sumber daya, aplikasi harus menggunakan salah satu fungsi khusus sumber daya berikut untuk menemukan sumber daya dan mengonversi data menjadi bentuk yang lebih dapat digunakan.
Fungsi | Tindakan |
---|---|
FormatMessage | Memuat dan memformat entri tabel pesan. |
LoadAccelerators | Memuat tabel akselerator. |
LoadBitmap | Memuat sumber daya bitmap. |
LoadCursor | Memuat sumber daya kursor. |
LoadIcon | Memuat sumber daya ikon. |
LoadMenu | Memuat sumber daya menu. |
LoadString | Memuat entri tabel string. |
Misalnya, aplikasi dapat menggunakan fungsi LoadIcon untuk memuat ikon untuk ditampilkan di layar. Namun, aplikasi harus menggunakan FindResourceEx dan LoadResource jika memuat ikon untuk menyalin datanya ke aplikasi lain.
Sumber daya string disimpan di bagian hingga 16 string per bagian. String di setiap bagian disimpan sebagai urutan string Unicode yang dihitung (belum tentu dihentikan null). Fungsi LoadString akan mengekstrak sumber daya string dari bagian yang sesuai.
Contoh
Misalnya, lihat Membuat Daftar Sumber Daya.
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 | winbase.h (termasuk Windows.h) |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |
Lihat juga
Konseptual
Sumber Daya Lain
Referensi
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk