Fungsi DownlevelLCIDToLocaleName

Artikel
12/21/2023

Mengonversi pengidentifikasi lokal menjadi nama lokal.

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 LCIDToLocaleName untuk mengambil nama lokal.

Sintaks

int DownlevelLCIDToLocaleName(
  _In_  LCID   Locale,
  _Out_ LPWSTR lpName,
  _In_  int    cchName,
  _In_  DWORD  dwFlags
);

Parameter

Lokal [di]

Pengidentifikasi lokal untuk diterjemahkan. Anda dapat menggunakan makro MAKELCID untuk membuat pengidentifikasi lokal. Fungsi ini tidak mendukung lokal netral atau nilai pengidentifikasi lokal tertentu berikut.

lpName [out]

Penunjuk ke buffer tempat fungsi ini mengambil nama lokal. Fungsi mengambil NULL jika cchName diatur ke 0.

cchName [in]

Ukuran, dalam titik kode UTF-16, dari buffer nama lokal. Aplikasi mengatur parameter ini ke 0 untuk mengembalikan ukuran buffer nama lokal yang diperlukan.

dwFlags [in]

Bendera yang menentukan jenis nama yang akan diambil. Nilai defaultnya adalah DOWNLEVEL_LOCALE_NAME.

Nilai hasil

Mengembalikan jumlah titik kode UTF-16 dalam nama lokal, termasuk karakter null yang mengakhiri, jika berhasil. Jika fungsi berhasil dan nilai cchName adalah 0, nilai yang dikembalikan adalah ukuran yang diperlukan, dalam karakter (termasuk karakter 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_FLAGS. Nilai dwFlags tidak valid.
ERROR_INVALID_PARAMETER. Salah satu nilai parameter tidak valid.

Keterangan

Catatan

Fungsi ini tidak mendukung lokal kustom.

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

Bagikan melalui