Bagikan melalui

Fungsi IsValidLocale (winnls.h)

  • Artikel

[IsValidLocale tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya. Sebagai gantinya, gunakan IsValidLocaleName untuk menentukan validitas lokal tambahan.]

Menentukan apakah lokal yang ditentukan diinstal atau didukung pada sistem operasi. Untuk informasi selengkapnya, lihat Lokal dan Bahasa.

Sintaks

BOOL IsValidLocale(
  [in] LCID  Locale,
  [in] DWORD dwFlags
);

Parameter

[in] Locale

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

[in] dwFlags

Bendera yang menentukan pengujian validitas untuk diterapkan ke pengidentifikasi lokal. Parameter ini dapat memiliki salah satu nilai berikut.

Nilai Makna
LCID_INSTALLED
 Tentukan apakah pengidentifikasi lokal didukung dan diinstal.
LCID_SUPPORTED
 Tentukan apakah pengidentifikasi lokal didukung.
0x39
 Jangan gunakan. Sebagai gantinya, gunakan LCID_INSTALLED.

Windows Server 2008, Windows Vista, Windows Server 2003, Windows XP, dan Windows 2000: Mengatur dwFlags ke 0x39 adalah kasus khusus yang dapat berperilaku seperti LCID_INSTALLED untuk beberapa lokal pada beberapa versi Windows.

Nilai kembali

Mengembalikan nilai bukan nol jika pengidentifikasi lokal lulus uji validitas yang ditentukan. Fungsi mengembalikan 0 jika tidak berhasil.

Keterangan

Jika bendera LCID_INSTALLED ditentukan dan fungsi ini mengembalikan nilai bukan nol, pengidentifikasi lokal didukung dan diinstal pada sistem operasi. Memiliki pengidentifikasi yang diinstal menyiratkan bahwa tingkat dukungan bahasa lengkap tersedia untuk lokal yang ditunjukkan. Dukungan penuh mencakup tabel terjemahan halaman kode, tata letak keyboard, font, serta pengurutan dan data lokal.

Jika LCID_SUPPORTED ditentukan dan fungsi ini mengembalikan 0, pengidentifikasi lokal didukung dalam rilis, tetapi belum tentu diinstal pada sistem operasi.

Fungsi ini dapat menangani 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.

Persyaratan

Persyaratan Nilai
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

GetLocaleInfo

IsValidLocaleName

Dukungan Bahasa Nasional

Fungsi Dukungan Bahasa Nasional