Fungsi IsValidLocaleName (winnls.h)

Artikel
03/08/2023

Menentukan apakah nama lokal yang ditentukan valid untuk lokal yang diinstal atau didukung pada sistem operasi.

Catatan Aplikasi yang hanya berjalan pada Windows Vista dan yang lebih baru harus memanggil fungsi ini di preferensi ke IsValidLocale untuk menentukan validitas lokal tambahan.

Sintaks

BOOL IsValidLocaleName(
  [in] LPCWSTR lpLocaleName
);

Parameter

[in] lpLocaleName

Arahkan ke nama lokal untuk divalidasi.

Menampilkan nilai

Mengembalikan nilai bukan nol jika nama lokal valid, atau mengembalikan 0 untuk nama yang tidak valid.

Keterangan

Pada Windows Vista dan yang lebih baru, semua lokal yang didukung harus diinstal pada semua sistem operasi.

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

Dimulai di Windows 8: Jika aplikasi Anda meneruskan tag bahasa ke fungsi ini dari namespace Windows.Globalization , aplikasi harus terlebih dahulu mengonversi tag dengan memanggil ResolveLocaleName.

Contoh

Contoh yang menunjukkan penggunaan fungsi ini dapat ditemukan di NLS: Sampel API berbasis nama.

Persyaratan


Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	winnls.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll