Fungsi DownlevelGetParentLocaleName
Mengambil nama lokal untuk induk lokal yang disediakan.
Catatan
Fungsi ini hanya digunakan oleh aplikasi yang berjalan pada sistem operasi Pra-Windows Vista. Penggunaannya memerlukan paket unduhan. Aplikasi yang hanya berjalan di Windows Vista dan yang lebih baru harus memanggil GetLocaleInfo dengan LCType diatur ke LOCALE_SPARENT.
Sintaks
int DownlevelGetParentLocaleName(
_In_ LCID Locale,
_Out_ LPWSTR lpName,
_In_ int cchName
);
Parameter
-
Lokal [di]
-
Pengidentifikasi lokal lokal. Anda dapat menggunakan makro MAKELCID untuk membuat pengidentifikasi lokal atau menggunakan salah satu nilai yang telah ditentukan sebelumnya berikut ini.
Windows Vista dan yang lebih baru: Pengidentifikasi lokal kustom berikut ini juga didukung.
-
lpName [out]
-
Penunjuk ke buffer tempat fungsi mengambil nama lokal induk, atau salah satu nilai yang telah ditentukan sebelumnya berikut. Parameter ini diatur ke NULL jika cchName diatur ke 0.
-
cchName [in]
-
Ukuran buffer yang ditunjukkan oleh lpName, dalam titik kode UTF-16. Nilai 0 untuk parameter ini menyebabkan fungsi mengabaikan buffer lpName dan mengembalikan ukuran buffer, dalam karakter (karakter null disertakan), yang diperlukan untuk berisi nama lokal induk.
Nilai hasil
Mengembalikan jumlah titik kode UTF-16 dalam 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.
- ERROR_INVALID_PARAMETER. Salah satu nilai parameter tidak valid.
Keterangan
File header dan DLL yang diperlukan adalah bagian dari unduhan "API Pemetaan Data Downlevel Microsoft NLS", yang tidak lagi tersedia dari Pusat Unduhan Microsoft. Gunakan API globalisasi ICU pada versi Pembaruan Windows 10 Mei 2019 dan yang lebih baru.
Persyaratan
| Persyaratan | Value |
|---|---|
| Klien minimum yang didukung |
Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows Server 2003 [hanya aplikasi desktop] |
| Redistribusi |
API Pemetaan Data Downlevel Microsoft NLS diWindows XP dengan SP2 dan yang lebih baru |
| Header |
|
| DLL |
|
Baca juga