Fungsi GetSystemDefaultLocaleName (winnls.h)

Artikel
03/08/2023

Mengambil nama lokal default sistem.

Catatan Disarankan agar aplikasi memanggil GetUserDefaultLocaleName di preferensi atas fungsi ini. Hal ini disebabkan oleh lokal pengguna umumnya lebih berguna dan akurat bagi pengguna daripada lokal sistem.

Catatan Aplikasi harus memanggil fungsi ini disukai ke GetSystemDefaultLCID jika dirancang untuk berjalan hanya di Windows Vista dan yang lebih baru.

Sintaks

int GetSystemDefaultLocaleName(
  [out] LPWSTR lpLocaleName,
  [in]  int    cchLocaleName
);

Parameter

[out] lpLocaleName

Penunjuk ke buffer tempat fungsi ini mengambil nama lokal.

[in] cchLocaleName

Ukuran, dalam karakter, dari buffer output yang ditunjukkan oleh lpLocaleName. Panjang karakter maksimum yang mungkin dari nama lokal (termasuk karakter null yang mengakhiri) adalah nilai LOCALE_NAME_MAX_LENGTH. Ini adalah ukuran yang disarankan.

Nilai kembali

Mengembalikan nilai yang lebih besar dari 0 yang menunjukkan panjang nama lokal, termasuk karakter null yang mengakhiri, jika berhasil.

Fungsi ini mengembalikan 0 jika tidak berhasil. Untuk mendapatkan informasi kesalahan yang diperluas, aplikasi dapat memanggil GetLastError, yang dapat mengembalikan salah satu kode kesalahan berikut:

ERROR_INSUFFICIENT_BUFFER. Ukuran buffer yang disediakan tidak cukup besar, atau salah diatur ke NULL.

Keterangan

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

Contoh

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

Persyaratan

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