Fungsi FindResourceA (winbase.h)

Artikel
03/08/2023

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

Untuk menentukan bahasa, gunakan fungsi FindResourceEx .

Sintaks

HRSRC FindResourceA(
  [in, optional] HMODULE hModule,
  [in]           LPCSTR  lpName,
  [in]           LPCSTR  lpType
);

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

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 = lpName atau lpType, x menentukan pengidentifikasi bilangan bulat dari nama atau jenis 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 FindResource 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 FindResource 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 Memperbarui 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