Fungsi ResolveLocaleName (winnls.h)

Artikel
08/27/2023

Menemukan kemungkinan kecocokan nama lokal untuk nama yang disediakan.

Sintaks

int ResolveLocaleName(
  [in, optional]  LPCWSTR lpNameToResolve,
  [out, optional] LPWSTR  lpLocaleName,
  [in]            int     cchLocaleName
);

Parameter

[in, optional] lpNameToResolve

Arahkan ke nama untuk mengatasi, misalnya, "en-XA" untuk bahasa Inggris (Penggunaan Privat).

[out, optional] lpLocaleName

Penunjuk ke buffer di mana fungsi ini mengambil nama lokal yang cocok untuk nama input. Misalnya, kecocokan untuk nama "en-XA" adalah "en-US" untuk bahasa Inggris (Amerika Serikat).

Catatan Jika fungsi gagal, status buffer output tidak dijamin akurat. Dalam hal ini, aplikasi harus memeriksa nilai pengembalian dan status kesalahan yang ditetapkan oleh fungsi untuk menentukan tindakan yang benar.

[in] cchLocaleName

Ukuran, dalam karakter, dari buffer yang ditunjukkan oleh lpLocaleName. Panjang maksimum yang mungkin dari nama lokal, termasuk karakter null yang mengakhiri, adalah nilai LOCALE_NAME_MAX_LENGTH. Ini adalah ukuran yang disarankan untuk disuplai dalam parameter ini.

Mengembalikan nilai

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

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

Nama lokal yang diambil menunjukkan lokal tertentu, termasuk bahasa dan negara/wilayah, bahkan jika bahasa input netral. Misalnya, input "en" untuk bahasa Inggris (Amerika Serikat) menyebabkan fungsi mengambil "en-US".

Fungsi ini dapat mengambil data dari lokal kustom. Data tidak dijamin sama dari komputer ke komputer atau antara eksekusi aplikasi, juga tidak mengembalikan jaminan lokal yang valid bahwa itu akan valid di komputer lain. Jika aplikasi Anda harus mempertahankan atau mengirimkan data, lihat Menggunakan Data Lokal Persisten.

Dimulai di Windows 8: Tag bahasa yang diperoleh dari namespace Windows.Globalization harus dikonversi oleh ResolveLocaleName sebelum dapat digunakan dengan fungsi Dukungan Bahasa Nasional apa pun.

Persyaratan


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

Lihat juga

Dukungan Bahasa Nasional

Fungsi Dukungan Bahasa Nasional

Windows.Globalization

Bagikan melalui