Fungsi IsNormalizedString (winnls.h)
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.
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 |