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.

Syntax

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

Parameter-parameternya

[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 penghentian null. Jika nilai ini adalah -1, fungsi mengasumsikan string dihentikan null dan menghitung panjang secara otomatis.

Mengembalikan nilai

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).

Komentar

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.

Examples

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

Persyaratan

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

Lihat juga

NORM_FORM

Dukungan Bahasa Nasional

Fungsi Dukungan Bahasa Nasional

NormalizeString

Menggunakan Normalisasi Unicode untuk Mewakili String