Fungsi DownlevelLocaleNameToLCID

Artikel
12/21/2023

Mengonversi nama lokal ke pengidentifikasi lokal yang dapat digunakan untuk mendapatkan informasi dari sistem operasi.

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 LocaleNameToLCID untuk mengambil pengidentifikasi lokal.

Sintaks

LCID DownlevelLocaleNameToLCID(
  _In_ LPWSTR lpName,
  _In_ DWORD  dwFlags
);

Parameter

lpName [in]: Penunjuk ke string null-terminated yang mewakili nama lokal.
dwFlags [in]: Bendera yang menentukan jenis nama. Defaultnya adalah DOWNLEVEL_LOCALE_NAME.

Nilai hasil

Mengembalikan pengidentifikasi lokal yang sesuai dengan nama lokal 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_INVALID_FLAGS. Nilai yang disediakan untuk bendera tidak valid.
ERROR_INVALID_PARAMETER. Salah satu nilai parameter tidak valid.

Keterangan

Catatan

Fungsi ini tidak mendukung lokal netral. Fungsi LocaleNameToLCID yang setara mendukung lokal kustom, tetapi hanya untuk Windows Vista dan yang lebih baru.

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