Fungsi DownlevelVerifyScripts

Artikel
12/21/2023

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	Idndl.h
DLL	Idndl.dll

Bagikan melalui