Fungsi DownlevelGetParentLocaleName

Artikel
12/21/2023

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	Nlsdl.h
DLL	NlsMap.dll

Bagikan melalui