Fungsi panggilan balik ENUMRESNAMEPROCA (libloaderapi.h)

Fungsi panggilan balik yang ditentukan aplikasi yang digunakan dengan fungsi EnumResourceNames dan EnumResourceNamesEx. Ini menerima jenis dan nama sumber daya. Jenis ENUMRESNAMEPROC menentukan penunjuk ke fungsi panggilan balik ini. EnumResNameProc adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.

Sintaksis

ENUMRESNAMEPROCA Enumresnameproca;

BOOL Enumresnameproca(
  [in, optional] HMODULE hModule,
                 LPCSTR lpType,
                 LPSTR lpName,
  [in]           LONG_PTR lParam
)
{...}

Parameter

[in, optional] hModule

Jenis: HMODULE

Handel ke modul yang file yang dapat dieksekusi berisi sumber daya yang sedang dijumlahkan. Jika parameter ini NULL, fungsi menghitung nama sumber daya dalam modul yang digunakan untuk membuat proses saat ini.

lpType

Jenis: LPCTSTR

Jenis sumber daya yang namanya sedang dijumlahkan. Secara bergantian, bukan penunjuk, parameter ini dapat MAKEINTRESOURCE(ID), di mana ID adalah nilai bilangan bulat yang mewakili jenis sumber daya yang telah ditentukan sebelumnya. Untuk jenis sumber daya standar, lihat Jenis Sumber Daya. Untuk informasi selengkapnya, lihat bagian Keterangan di bawah ini.

lpName

Jenis: LPTSTR

Nama sumber daya jenis yang sedang dijumlahkan. Secara bergantian, daripada penunjuk, parameter ini dapat MAKEINTRESOURCE(ID), di mana ID adalah pengidentifikasi bilangan bulat sumber daya. Untuk informasi selengkapnya, lihat bagian Keterangan di bawah ini.

[in] lParam

Jenis: LONG_PTR

Parameter yang ditentukan aplikasi diteruskan ke fungsi EnumResourceNames atau EnumResourceNamesEx. Parameter ini dapat digunakan dalam pemeriksaan kesalahan.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan TRUE untuk melanjutkan enumerasi atau FALSE untuk menghentikan enumerasi.

Komentar

Jika IS_INTRESOURCE(lpszType) TRUE, maka lpszType menentukan pengidentifikasi bilangan bulat dari jenis sumber daya yang diberikan. Jika tidak, ini adalah penunjuk ke string yang dihentikan null. Jika karakter pertama string adalah tanda pound (#), maka karakter yang tersisa mewakili angka desimal yang menentukan pengidentifikasi bilangan bulat dari jenis sumber daya. Misalnya, string "#258" mewakili pengidentifikasi 258.

Demikian pula, jika IS_INTRESOURCE(lpszName) TRUE, maka lpszName menentukan pengidentifikasi bilangan bulat dari sumber daya yang diberikan. Jika tidak, ini adalah penunjuk ke string yang dihentikan null. Jika karakter pertama string adalah tanda pound (#), maka karakter yang tersisa mewakili angka desimal yang menentukan pengidentifikasi bilangan bulat sumber daya.

Aplikasi harus mendaftarkan fungsi ini dengan meneruskan alamatnya ke fungsi EnumResourceNames atau EnumResourceNamesEx.

Jika fungsi panggilan balik mengembalikan FALSE, maka EnumResourceNames atau EnumResourceNamesEx akan menghentikan enumerasi dan mengembalikan FALSE. Pada Windows XP dan sebelumnya nilai yang diperoleh dari GetLastError akan ERROR_SUCCESS; dimulai dengan Windows Vista, nilai kesalahan terakhir akan ERROR_RESOURCE_ENUM_USER_STOP.

Nota

Header libloaderapi.h mendefinisikan ENUMRESNAMEPROC sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	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)

Lihat juga

Konseptual

EnumResourceNames

EnumResourceNamesEx

IS_INTRESOURCE

Referensi

Sumber Daya