Fungsi GetUserDefaultLocaleName (winnls.h)

Artikel
03/13/2024

Mengambil nama lokal default pengguna.

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

Sintaks

int GetUserDefaultLocaleName(
  [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 yang ditunjukkan oleh lpLocaleName. Panjang maksimum yang mungkin dari nama lokal, termasuk karakter null yang mengakhiri, adalah LOCALE_NAME_MAX_LENGTH. Ini adalah ukuran yang disarankan untuk disuplai dalam parameter ini.

Nilai kembali

Mengembalikan ukuran buffer yang berisi nama lokal, termasuk karakter null yang mengakhiri, jika berhasil.

Catatan Pada sistem pengguna tunggal, nilai yang dikembalikan sama dengan yang dikembalikan oleh GetSystemDefaultLocaleName.

Fungsi 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.

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