Fungsi panggilan balik ENUMRESTYPEPROCA (libloaderapi.h)

Artikel
11/20/2024

Fungsi panggilan balik yang ditentukan aplikasi yang digunakan dengan fungsi EnumResourceTypes dan EnumResourceTypesEx. Ini menerima jenis sumber daya. Jenis ENUMRESTYPEPROC menentukan penunjuk ke fungsi panggilan balik ini. EnumResTypeProc adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.

Sintaksis

ENUMRESTYPEPROCA Enumrestypeproca;

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

Parameter

[in, optional] hModule

Jenis: HMODULE

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

lpType

Jenis: LPTSTR

Jenis sumber daya yang jenisnya sedang dijumlahkan.

Sebagai alternatif, daripada pointer, parameter ini dapat 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] lParam

Jenis: LONG_PTR

Parameter yang ditentukan aplikasi diteruskan ke fungsi EnumResourceTypes atau EnumResourceTypesEx. 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.

Aplikasi harus mendaftarkan fungsi ini dengan meneruskan alamatnya ke fungsi EnumResourceTypes atau EnumResourceTypesEx.

Jika fungsi panggilan balik mengembalikan FALSE, maka EnumResourceTypes atau EnumResourceTypesEx 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 ENUMRESTYPEPROC 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

EnumResourceTypes

EnumResourceTypesEx

IS_INTRESOURCE

Referensi

Sumber Daya

Bagikan melalui