Fungsi EnumCalendarInfoA (winnls.h)

Artikel
08/27/2023

Menghitung informasi kalender untuk lokal tertentu.

Catatan Untuk menerima pengidentifikasi kalender selain informasi kalender, aplikasi harus menggunakan fungsi EnumCalendarInfoEx . Alasan lain untuk lebih memilih fungsi ini adalah bahwa Microsoft bermigrasi ke penggunaan nama lokal alih-alih pengidentifikasi lokal untuk lokal baru, karena alasan interoperabilitas.

Catatan Aplikasi apa pun yang hanya akan dijalankan di Windows Vista dan yang lebih baru harus menggunakan EnumCalendarInfoExEx disukai enumCalendarInfo.

Sintaks

BOOL EnumCalendarInfoA(
  [in] CALINFO_ENUMPROCA lpCalInfoEnumProc,
  [in] LCID              Locale,
  [in] CALID             Calendar,
  [in] CALTYPE           CalType
);

Parameter

[in] lpCalInfoEnumProc

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

[in] Locale

Pengidentifikasi lokal yang menentukan lokal untuk mengambil informasi kalender. Anda bisa menggunakan makro MAKELCID untuk membuat pengidentifikasi lokal atau menggunakan 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] CalType

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

Nilai kembali

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 diberikan untuk bendera tidak valid.
ERROR_INVALID_PARAMETER. Salah satu nilai parameter tidak valid.

Keterangan

Lihat Keterangan untuk EnumCalendarInfoEx.

Catatan

Header winnls.h mendefinisikan EnumCalendarInfo sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winnls.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll