Fungsi DownlevelGetLocaleScripts
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 |
|
| DLL |
|
Baca juga