Fungsi FindResourceA (winbase.h)

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

Lihat juga

Konseptual

FindResourceEx

FormatMessage

IS_INTRESOURCE

LoadAccelerators

LoadBitmap

LoadCursor

LoadIcon

LoadMenu

LoadResource

LoadString

LockResource

Sumber Daya Lain

Referensi

Sumber

SizeofResource