Fungsi FindResourceExW (libloaderapi.h)

Menentukan lokasi sumber daya dengan jenis, nama, dan bahasa yang ditentukan dalam modul yang ditentukan.

Syntax

HRSRC FindResourceExW(
  [in, optional] HMODULE hModule,
  [in]           LPCWSTR lpType,
  [in]           LPCWSTR lpName,
  [in]           WORD    wLanguage
);

Parameter-parameternya

[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 jenis sumber daya yang diberikan. 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

Jenis: 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 pengembalian 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, panggil GetLastError.

Komentar

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 pound (#), 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 jenis sumber daya apa pun, 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.

Function	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 string-table.

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 dalam 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.

Persyaratan

Persyaratan	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	libloaderapi.h (termasuk Windows.h)
Library	kernel32. Lib
DLL	Kernel32.dll

Lihat juga

FindResource
FormatMessage
IS_INTRESOURCE
LoadAccelerators
LoadBitmap
LoadCursor
LoadIcon
LoadMenu
LoadResource
LoadString
MAKELANGID

Sumber Daya Lain

Referensi
Sumber Daya