Fungsi DownlevelVerifyScripts
Membandingkan dua daftar skrip yang dijumlahkan.
Catatan
Fungsi ini hanya digunakan oleh aplikasi yang berjalan pada sistem operasi Pra-Windows Vista. Penggunaannya memerlukan paket unduhan. Aplikasi yang hanya berjalan pada Windows Vista dan yang lebih baru harus memanggil VerifyScripts.
Sintaks
BOOL DownlevelVerifyScripts(
_In_ DWORD dwFlags,
_In_ LPCWSTR lpLocaleScripts,
_In_ int cchLocaleScripts,
_In_ LPCWSTR lpTestScripts,
_In_ int cchTestScripts
);
Parameter
-
dwFlags [in]
-
Bendera yang menentukan opsi verifikasi skrip.
Value Makna - VS_ALLOW_LATIN
Izinkan "Latn" (skrip Latin) dalam daftar pengujian, bahkan jika tidak ada dalam daftar lokal. -
lpLocaleScripts [in]
-
Penunjuk ke daftar lokal, daftar skrip yang dijumlahkan untuk lokal tertentu. Daftar ini biasanya diisi dengan memanggil DownlevelGetLocaleScripts.
-
cchLocaleScripts [in]
-
Ukuran, dalam karakter, dari string yang ditunjukkan oleh lpLocaleScripts. Aplikasi mengatur parameter ini ke -1 jika string dihentikan null. Jika parameter ini diatur ke 0, fungsi gagal.
-
lpTestScripts [in]
-
Penunjuk ke daftar pengujian, daftar skrip kedua yang dijumlahkan. Daftar ini biasanya diisi dengan memanggil DownlevelGetStringScripts.
-
cchTestScripts [in]
-
Ukuran, dalam karakter, dari string yang ditunjukkan oleh lpTestScripts. Aplikasi mengatur parameter ini ke -1 jika string dihentikan null. Jika parameter ini diatur ke 0, fungsi gagal.
Nilai hasil
Mengembalikan TRUE jika daftar pengujian tidak kosong dan semua item dalam daftar juga disertakan dalam daftar lokal. Jika tidak, fungsi mengembalikan FALSE.
Nilai pengembalian FALSE dapat menunjukkan bahwa daftar pengujian berisi item yang tidak ada dalam daftar lokal, atau dapat menunjukkan kesalahan. Untuk membedakan antara kedua kasus ini, aplikasi dapat memanggil GetLastError. Jika DownlevelVerifyScripts berhasil menentukan bahwa ada item dalam daftar pengujian yang tidak ada dalam daftar lokal, GetLastError mengembalikan ERROR_SUCCESS. Jika tidak, GetLastError 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
Fungsi ini membandingkan string, seperti "Latn; Cyrl;", yang terdiri dari serangkaian nama skrip 4 karakter, dengan setiap nama skrip diikuti dengan titik koma. Ini juga memiliki kasus khusus untuk memperhitungkan fakta bahwa skrip Latin sering digunakan dalam bahasa dan lokal yang tidak asli.
Fungsi ini berguna sebagai bagian dari strategi untuk mengurangi masalah keamanan yang terkait dengan nama domain internasional (IDN).
Berikut ini adalah contoh pengembalian fungsi ini dan panggilan berikutnya ke GetLastError dalam berbagai skenario. Dua contoh terakhir mengilustrasikan, masing-masing, kasus di mana daftar pengujian tidak memiliki titik koma yang mengakhiri (string cacat) dan kasus di mana daftar pengujian kosong.
| String "Lokal" | String "Uji" | dwFlags | Nilai hasil | GetLastError kembali |
|---|---|---|---|---|
| Hani; Hira; Kana; | Hani; | T/A | BENAR | T/A |
| Hani; Hira; Kana; | Hani; Latn; | 0 | SALAH | ERROR_SUCCESS |
| Hani; Hira; Kana; | Hani; Latn; | VS_ALLOW_LATIN | BENAR | T/A |
| Hani; Hira; Kana; | Siri; | T/A | SALAH | ERROR_SUCCESS |
| Hani; Hira; Kana; | Siri; | T/A | SALAH | ERROR_INVALID_PARAMETER |
| Hani; Hira; Kana; | T/A | SALAH | ERROR_SUCCESS |
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) diWindows XP dengan SP2,Windows Server 2003 dengan SP1, atauWindows Vista |
| Header |
|
| DLL |
|
Baca juga