Fungsi LCIDToLocaleName (winnls.h)

Mengonversi pengidentifikasi lokal menjadi nama lokal.

Catatan Untuk lokal kustom, termasuk yang dibuat oleh Microsoft, aplikasi Anda harus lebih memilih nama lokal daripada pengidentifikasi lokal.

 

Sintaks

int LCIDToLocaleName(
  [in]            LCID   Locale,
  [out, optional] LPWSTR lpName,
  [in]            int    cchName,
  [in]            DWORD  dwFlags
);

Parameter

[in] Locale

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

• LOCALE_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT

Windows Vista: Pengidentifikasi lokal kustom berikut ini juga didukung.

• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED

[out, optional] lpName

Penunjuk ke buffer tempat fungsi ini mengambil nama lokal, atau salah satu nilai yang telah ditentukan sebelumnya berikut.

• LOCALE_NAME_INVARIANT
• LOCALE_NAME_SYSTEM_DEFAULT
• LOCALE_NAME_USER_DEFAULT

[in] cchName

Ukuran, dalam karakter, dari buffer nama lokal. Panjang maksimum kemungkinan nama lokal, termasuk karakter null yang mengakhiri, adalah LOCALE_NAME_MAX_LENGTH. Ini adalah ukuran yang direkomendasikan untuk memasok parameter ini.

Atau, aplikasi dapat mengatur parameter ini ke 0. Dalam hal ini, fungsi mengembalikan ukuran yang diperlukan untuk buffer nama lokal.

[in] dwFlags

Sebelum Windows 7: Dipesan; harus selalu 0.

Dimulai dengan Windows 7: Dapat diatur ke LOCALE_ALLOW_NEUTRAL_NAMES untuk memungkinkan kembalinya nama netral.

Mengembalikan nilai

Mengembalikan jumlah karakter, termasuk karakter null yang mengakhiri, dalam nama lokal jika berhasil. Jika fungsi berhasil dan nilai cchName adalah 0, nilai yang dikembalikan adalah ukuran yang diperlukan, dalam karakter (termasuk null), untuk buffer nama lokal.

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.
• ERROR_INVALID_PARAMETER. Salah satu nilai parameter tidak valid.

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

Lihat juga

LocaleNameToLCID

Dukungan Bahasa Nasional

Fungsi Dukungan Bahasa Nasional