Fungsi SetLocaleInfoA (winnls.h)

Artikel
11/20/2024

Mengatur item informasi dalam bagian penimpaan pengguna dari lokal saat ini. Fungsi ini tidak mengatur default sistem.

Hati-hati Karena fungsi ini memodifikasi nilai untuk semua aplikasi, fungsi ini hanya boleh dipanggil oleh fungsionalitas opsi regional dan bahasa Panel Kontrol, atau utilitas serupa. Jika membuat perubahan internasional pada parameter sistem, aplikasi panggilan harus menyiarkan pesan WM_SETTINGCHANGE untuk menghindari menyebabkan ketidakstabilan di aplikasi lain.

Sintaksis

BOOL SetLocaleInfoA(
  [in] LCID   Locale,
  [in] LCTYPE LCType,
  [in] LPCSTR lpLCData
);

Parameter

[in] Locale

Untuk versi ANSI fungsi, pengidentifikasi lokal lokal dengan halaman kode yang digunakan saat menginterpretasikan informasi lpLCData . Untuk versi Unicode, parameter ini diabaikan.

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] LCType

Jenis informasi lokal yang akan diatur. Untuk konstanta yang valid, lihat bagian "Konstanta yang Digunakan dalam Parameter LCType dari GetLocaleInfo, GetLocaleInfoEx, dan SetLocaleInfo" di Konstanta Informasi Lokal. Aplikasi hanya dapat menentukan satu nilai per panggilan, tetapi dapat menggunakan operator OR biner untuk menggabungkan LOCALE_USE_CP_ACP dengan konstanta lainnya.

[in] lpLCData

Penunjuk ke string null-terminated yang berisi informasi lokal untuk diatur. Informasi harus dalam format khusus untuk konstanta yang ditentukan. Aplikasi ini menggunakan string Unicode untuk versi Unicode fungsi, dan string ANSI untuk versi ANSI.

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_ACCESS_DISABLED_BY_POLICY. Kebijakan grup komputer atau pengguna telah melarang operasi ini.
ERROR_INVALID_ACCESS. Kode akses tidak valid.
ERROR_INVALID_FLAGS. Nilai yang disediakan untuk bendera tidak valid.
ERROR_INVALID_PARAMETER. Salah satu nilai parameter tidak valid.

Komentar

Fungsi ini menulis ke registri, di mana ia menetapkan nilai yang terkait dengan pengguna tertentu alih-alih aplikasi tertentu. Nilai registri ini memengaruhi perilaku aplikasi lain yang dijalankan oleh pengguna. Sebagai aturan, aplikasi harus memanggil fungsi ini hanya ketika pengguna secara eksplisit meminta perubahan. Pengaturan registri tidak boleh diubah untuk kenyamanan satu aplikasi.

Untuk parameter LCType, aplikasi harus mengatur LOCALE_USE_CP_ACP untuk menggunakan halaman kode ANSI sistem operasi alih-alih halaman kode lokal untuk terjemahan string.

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

Pada Windows Vista, konstanta LOCALE_SDATE dan LOCALE_STIME usang. Jangan gunakan konstanta ini. Gunakan LOCALE_SSHORTDATE dan LOCALE_STIMEFORMAT sebagai gantinya. Lokal kustom mungkin tidak memiliki satu karakter pemisah seragam dalam format tanggal atau waktu: misalnya, format seperti "31/12, 2006" atau "03:56'23" mungkin valid.

Nota

Header winnls.h mendefinisikan SetLocaleInfo sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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	winnls.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

GetLocaleInfo

Dukungan Bahasa Nasional

Fungsi Dukungan Bahasa Nasional

Bagikan melalui