Fungsi EnumCalendarInfoExA (winnls.h)

Artikel
08/27/2023

Menghitung informasi kalender untuk lokal yang ditentukan oleh pengidentifikasi.

Catatan Aplikasi apa pun yang hanya berjalan di Windows Vista dan yang lebih baru harus menggunakan EnumCalendarInfoExEx disukai untuk fungsi ini.

Sintaks

BOOL EnumCalendarInfoExA(
  [in] CALINFO_ENUMPROCEXA lpCalInfoEnumProcEx,
  [in] LCID                Locale,
  [in] CALID               Calendar,
  [in] CALTYPE             CalType
);

Parameter

[in] lpCalInfoEnumProcEx

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

[in] Locale

Pengidentifikasi lokal yang menentukan lokal untuk mengambil informasi kalender. Anda bisa menggunakan makro MAKELCID untuk membuat pengidentifikasi atau menggunakan salah satu nilai yang telah ditentukan sebelumnya berikut ini.

Windows Vista dan yang lebih baru: Pengidentifikasi lokal kustom berikut ini juga didukung.

[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

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. Proses ini berlanjut hingga EnumCalendarInfoEx menemukan kalender terakhir yang berlaku atau fungsi panggilan balik mengembalikan FALSE.

Fungsi ini dapat menghitung data dari lokal kustom. Data tidak dijamin sama dari komputer ke komputer atau antara eksekusi aplikasi. Jika aplikasi Anda harus mempertahankan atau mengirimkan data, lihat Menggunakan Data Lokal Persisten.

Ketika versi ANSI dari fungsi ini digunakan dengan pengidentifikasi lokal khusus Unicode, fungsi dapat berhasil karena sistem operasi menggunakan halaman kode sistem. Namun, karakter yang tidak ditentukan di halaman kode sistem muncul dalam string sebagai tanda tanya (?).

Catatan

Header winnls.h mendefinisikan EnumCalendarInfoEx 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