Fungsi EnumCalendarInfoExEx (winnls.h)

Artikel
03/13/2024

Menghitung informasi kalender untuk lokal yang ditentukan berdasarkan nama.

Catatan Aplikasi harus memanggil fungsi ini sebagai preferensi ke EnumCalendarInfo atau EnumCalendarInfoEx jika dirancang untuk berjalan hanya di Windows Vista dan yang lebih baru.

Catatan Fungsi ini dapat menghitung data yang berubah di antara rilis, misalnya, karena lokal kustom. Jika aplikasi Anda harus mempertahankan atau mengirimkan data, lihat Menggunakan Data Lokal Persisten.

Sintaks

BOOL EnumCalendarInfoExEx(
  [in]           CALINFO_ENUMPROCEXEX pCalInfoEnumProcExEx,
  [in, optional] LPCWSTR              lpLocaleName,
  [in]           CALID                Calendar,
  [in, optional] LPCWSTR              lpReserved,
  [in]           CALTYPE              CalType,
  [in]           LPARAM               lParam
);

Parameter

[in] pCalInfoEnumProcExEx

Penunjuk ke fungsi panggilan balik yang ditentukan aplikasi. Untuk informasi selengkapnya, lihat EnumCalendarInfoProcExEx.

[in, optional] lpLocaleName

Arahkan ke nama lokal, atau salah satu nilai yang telah ditentukan sebelumnya berikut ini.

[in] Calendar

Pengidentifikasi kalender yang menentukan kalender yang informasinya diminta. Perhatikan bahwa pengidentifikasi ini dapat ENUM_ALL_CALENDARS, untuk menghitung semua kalender yang terkait dengan lokal.

[in, optional] lpReserved

Dipesan; harus NULL.

[in] CalType

Jenis informasi kalender. Untuk informasi selengkapnya, lihat Informasi Jenis Kalender. Hanya satu jenis kalender yang dapat ditentukan per panggilan ke fungsi ini, kecuali jika disebutkan.

[in] lParam

Parameter yang disediakan aplikasi untuk diteruskan ke fungsi panggilan balik. Nilai ini sangat berguna untuk aplikasi multi-utas.

Mengembalikan nilai

Mengembalikan nilai bukan nol jika berhasil, atau 0 sebaliknya. Untuk mendapatkan informasi kesalahan yang diperluas, aplikasi dapat memanggil GetLastError, yang dapat mengembalikan salah satu kode kesalahan berikut:

ERROR_INVALID_FLAGS. Nilai yang disediakan untuk bendera tidak valid.
ERROR_INVALID_PARAMETER. Salah satu nilai parameter tidak valid.

Keterangan

Fungsi ini menghitung informasi kalender untuk semua kalender yang berlaku untuk lokal yang ditentukan, atau untuk satu kalender yang diminta, tergantung pada nilai parameter Kalender . Fungsi menghitung informasi kalender dengan memanggil fungsi panggilan balik yang ditentukan aplikasi yang ditentukan. Ini meneruskan fungsi panggilan balik penunjuk ke buffer yang berisi informasi kalender yang diminta, pengidentifikasi kalender, dan parameter yang ditentukan aplikasi yang berguna untuk aplikasi multi-utas. Proses ini berlanjut hingga EnumCalendarInfoExEx menemukan kalender terakhir yang berlaku atau fungsi panggilan balik mengembalikan FALSE.

Dimulai di Windows 8: Jika aplikasi Anda meneruskan tag bahasa ke fungsi ini dari namespace Windows.Globalization, aplikasi harus terlebih dahulu mengonversi tag dengan memanggil ResolveLocaleName.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	winnls.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll