Fungsi DownlevelGetLocaleScripts

Artikel
06/13/2023

Menyediakan daftar skrip untuk lokal yang ditentukan.

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_SSCRIPTS.

Sintaks

int DownlevelGetLocaleScripts(
  _In_  LPCWSTR lpLocaleName,
  _Out_ LPWSTR  lpScripts,
  _In_  int     cchScripts
);

Parameter

lpLocaleName [in]

Penunjuk ke nama lokal yang dihentikan null.

lpScripts [out]

Pointer ke buffer di mana fungsi ini mengambil string null-terminated yang mewakili daftar skrip, menggunakan notasi 4 karakter yang digunakan dalam ISO 15924. Setiap nama skrip terdiri dari empat karakter Latin, dan nama diambil dalam urutan alfabet. Masing-masing, termasuk yang terakhir, diikuti oleh titik koma.

Atau, parameter ini dapat berisi NULL jika cchScripts diatur ke 0. Dalam hal ini, fungsi mengembalikan ukuran yang diperlukan untuk buffer skrip.

cchScripts [in]

Ukuran, dalam karakter, untuk buffer skrip yang ditunjukkan oleh lpScripts.

Atau, aplikasi dapat mengatur parameter ini ke 0. Dalam hal ini, fungsi mengambil NULL dalam lpScripts dan mengembalikan ukuran yang diperlukan untuk buffer skrip.

Nilai hasil

Mengembalikan jumlah karakter yang diambil dalam buffer skrip, termasuk karakter null yang dihentikan. Jika fungsi berhasil dan nilai cchScripts adalah 0, nilai yang dikembalikan adalah ukuran yang diperlukan, dalam karakter termasuk karakter null yang mengakhiri, untuk buffer skrip.

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_BADDB. Fungsi tidak dapat mengakses data. Situasi ini biasanya tidak boleh terjadi, dan biasanya menunjukkan instalasi yang buruk, masalah disk, atau sejenisnya.
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

Fungsi ini berguna sebagai bagian dari strategi untuk mengurangi masalah keamanan yang terkait dengan nama domain internasional (IDN).

Berikut adalah beberapa contoh input dan output untuk fungsi ini, dengan asumsi ukuran buffer yang memadai:

Lokal	lpLocaleName	lpScripts
Inggris (Amerika Serikat)	id-ID	Latn;
Hindi (India)	hi-IN	Deva;
Jepang (Jepang)	ja-JP	Hani; Hira; Kana;

Daftar tidak berisi skrip Latin kecuali itu adalah bagian penting dari sistem penulisan yang digunakan untuk lokal. Namun, karakter Latin sering digunakan dalam konteks lokal yang mereka tidak asli, seperti untuk nama bisnis asing. Dalam contoh di atas untuk Hindi di India, satu-satunya skrip yang diambil adalah "Deva" (untuk Devanagari), meskipun karakter Latin juga dapat muncul dalam teks Hindi. Fungsi DownlevelVerifyScripts memiliki bendera khusus untuk mengatasi kasus tersebut.

File header dan DLL yang diperlukan adalah bagian dari unduhan "API Mitigasi Nama Domain Internasional Microsoft (IDN) yang tersedia dari archive.org.

Persyaratan

Persyaratan	Value
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Redistribusi	API Mitigasi Nama Domain Internasional Microsoft (IDN) pada Windows XP (SP2 atau yang lebih baru), Windows Server 2003 (SP1 atau yang lebih baru), atau Windows Vista
Header	Idndl.h
DLL	Idndl.dll