Fungsi IsNormalizedString (winnls.h)

Artikel
08/27/2023

Memverifikasi bahwa string dinormalisasi sesuai dengan Unicode 4.0 TR#15. Untuk informasi selengkapnya, lihat Menggunakan Normalisasi Unicode untuk Mewakili String.

Sintaks

BOOL IsNormalizedString(
  [in] NORM_FORM NormForm,
  [in] LPCWSTR   lpString,
  [in] int       cwLength
);

Parameter

[in] NormForm

Formulir normalisasi yang akan digunakan. NORM_FORM menentukan formulir normalisasi Unicode standar.

[in] lpString

Arahkan ke string untuk diuji.

[in] cwLength

Panjang, dalam karakter, dari string input, termasuk karakter yang mengakhiri null. Jika nilai ini adalah -1, fungsi mengasumsikan string dihentikan null dan menghitung panjang secara otomatis.

Nilai kembali

Mengembalikan TRUE jika string input sudah dinormalisasi ke formulir yang sesuai, atau FALSE sebaliknya. Untuk mendapatkan informasi kesalahan yang diperluas, aplikasi dapat memanggil GetLastError, yang dapat mengembalikan salah satu kode kesalahan berikut:

ERROR_INVALID_PARAMETER. Salah satu nilai parameter tidak valid.
ERROR_NO_UNICODE_TRANSLATION. Unicode tidak valid ditemukan dalam string.
ERROR_SUCCESS. Tindakan berhasil diselesaikan tetapi tidak menghasilkan hasil.

Jika Anda perlu menentukan FALSE dengan andal dari kondisi kesalahan, maka harus memanggil SetLastError(ERROR_SUCCESS).

Keterangan

Windows XP, Windows Server 2003:

Tidak lagi didukung.

File header dan DLL yang diperlukan adalah bagian dari API Mitigasi Nama Domain Internasional Microsoft (IDN), yang tidak lagi tersedia untuk diunduh.

Contoh

Contoh yang menunjukkan penggunaan fungsi ini dapat ditemukan di NLS: Sampel Normalisasi Unicode.

Persyaratan


Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	winnls.h (termasuk Windows.h)
DLL	Normaliz.dll
Redistribusi	API Mitigasi Nama Domain Internasional Microsoft (IDN) diWindows XP dengan SP2 dan yang lebih baru, atauWindows Server 2003 dengan SP1