Fungsi ResolveLocaleName (winnls.h)
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).
[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 |