Fungsi SetCalendarInfoA (winnls.h)

Artikel
03/08/2023

Mengatur item informasi lokal untuk kalender. Untuk informasi selengkapnya, lihat Tanggal dan Kalender.

Sintaks

BOOL SetCalendarInfoA(
  [in] LCID    Locale,
  [in] CALID   Calendar,
  [in] CALTYPE CalType,
  [in] LPCSTR  lpCalData
);

Parameter

[in] Locale

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

Pengidentifikasi lokal kustom berikut ini juga didukung.

[in] Calendar

Pengidentifikasi kalender untuk kalender yang akan mengatur informasi.

[in] CalType

Tipe informasi kalender yang akan disetel. Hanya nilai CALTYPE berikut yang valid untuk fungsi ini. Konstanta CAL_USE_CP_ACP hanya bermakna untuk versi ANSI fungsi.

CAL_USE_CP_ACP
CAL_ITWODIGITYEARMAX

Aplikasi hanya dapat menentukan satu pengidentifikasi kalender per panggilan ke fungsi ini. Pengecualian dapat dilakukan jika aplikasi menggunakan operator BINER OR untuk menggabungkan CAL_USE_CP_ACP dengan nilai CALTYPE valid yang ditentukan dalam Informasi Jenis Kalender.

[in] lpCalData

Penunjuk ke string informasi kalender yang dihentikan null. Informasi harus dalam format tipe kalender yang ditentukan.

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_INTERNAL_ERROR. Terjadi kesalahan tak terduga dalam fungsi.
ERROR_INVALID_FLAGS. Nilai yang disediakan untuk bendera tidak valid.
ERROR_INVALID_PARAMETER. Salah satu nilai parameter tidak valid.

Keterangan

Fungsi ini hanya memengaruhi bagian penimpaan pengguna dari pengaturan kalender. Ini tidak mengatur default sistem.

Informasi kalender selalu diteruskan sebagai string Unicode yang dihentikan null dalam versi Unicode fungsi ini, dan sebagai string ANSI yang dihentikan null dalam versi ANSI. Tidak ada bilangan bulat yang diizinkan oleh fungsi ini. Nilai numerik apa pun harus ditentukan sebagai teks Unicode atau ANSI.

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 (?).

CAL_ITWODIGITYEARMAX dapat digunakan dengan kalender apa pun, meskipun kalender tidak didukung untuk lokal yang ditentukan. Untuk menghindari komplikasi, aplikasi harus memanggil EnumCalendarInfo untuk memastikan bahwa kalender didukung untuk lokal yang menarik.

Catatan

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

Lihat juga

EnumCalendarInfo

GetCalendarInfo

Dukungan Bahasa Nasional

Fungsi Dukungan Bahasa Nasional

Bagikan melalui