Fungsi FindResourceExA (winbase.h)

Artikel
08/27/2023

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