Fungsi CompareStringWrapW

[CompareStringWrapW tersedia untuk digunakan di Windows XP. Ini tidak akan tersedia dalam versi berikutnya. Anda harus menggunakan CompareStringW sebagai gantinya.]

Membandingkan dua string karakter Unicode, menggunakan lokal tertentu.

Catatan

CompareStringWrapW adalah pembungkus untuk fungsi CompareStringW . Lihat halaman CompareString untuk catatan penggunaan lebih lanjut.

 

Sintaks

int CompareStringWrapW(
  _In_ LCID    Locale,
  _In_ DWORD   dwCmpFlags,
  _In_ LPCWSTR lpString1,
  _In_ int     cchCount1,
  _In_ LPCWSTR lpString2,
  _In_ int     cchCount2
);

Parameter

Lokal [in]

Jenis: LCID

Pengidentifikasi lokal yang digunakan untuk perbandingan. Parameter ini dapat menjadi salah satu pengidentifikasi lokal yang telah ditentukan sebelumnya berikut atau pengidentifikasi lokal yang dibuat oleh makro MAKELCID .

LOCALE_SYSTEM_DEFAULT

Lokal default sistem.

LOCALE_USER_DEFAULT

Lokal default pengguna saat ini.

dwCmpFlags [in]

Jenis: DWORD

Bendera yang menunjukkan bagaimana fungsi membandingkan dua string. Secara default, bendera ini tidak diatur. Atur ke nol untuk mendapatkan perilaku default atau ke kombinasi apa pun dari nilai berikut.

NORM_IGNORECASE

Abaikan kasus.

NORM_IGNOREKANATYPE

Jangan membedakan antara karakter Hiragana dan Katakana. Karakter Hiragana dan Katakana yang sesuai dibandingkan sebagai sama.

NORM_IGNORENONSPACE

Abaikan karakter yang tidak terpakai.

NORM_IGNORESYMBOLS

Abaikan simbol.

NORM_IGNOREWIDTH

Jangan membedakan antara karakter byte tunggal dan karakter yang sama dengan karakter byte ganda.

SORT_STRINGSORT

Perlakukan tanda baca sama dengan simbol.

lpString1 [in]

Jenis: LPCWSTR

Penunjuk ke string Unicode pertama yang akan dibandingkan.

cchCount1 [in]

Jenis: int

Jumlah karakter dalam string yang ditujukkan oleh parameter lpString1 . Hitungan tidak termasuk karakter null yang mengakhiri. Jika parameter ini adalah nilai negatif, string diasumsikan sebagai null-dihentikan dan panjangnya dihitung secara otomatis.

lpString2 [in]

Jenis: LPCWSTR

Penunjuk ke string Unicode kedua yang akan dibandingkan.

cchCount2 [in]

Jenis: int

Jumlah karakter dalam string yang ditujukkan oleh parameter lpString2 . Hitungan tidak termasuk karakter null yang mengakhiri. Jika parameter ini adalah nilai negatif, string diasumsikan sebagai null-dihentikan dan panjangnya dihitung secara otomatis.

Nilai kembali

Jenis: int

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError. GetLastError dapat mengembalikan salah satu kode kesalahan berikut.

  • ERROR_INVALID_FLAGS
  • ERROR_INVALID_PARAMETER

Jika fungsi berhasil, nilai yang dikembalikan adalah salah satu nilai berikut.

Persyaratan Nilai
CSTR_LESS_THAN String yang ditujukkan oleh parameter lpString1 kurang dalam nilai leksikal daripada string yang ditujukkan oleh parameter lpString2 .
CSTR_EQUAL String yang ditujukkan oleh lpString1 sama dalam nilai leksikal ke string yang ditujukkan oleh lpString2.
CSTR_GREATER_THAN String yang ditujukkan oleh lpString1 lebih besar dalam nilai leksikal daripada string yang ditujukkan oleh lpString2

 

Keterangan

Peringatan Keamanan: Menggunakan fungsi ini salah dapat membahayakan keamanan aplikasi Anda. String yang tidak dibandingkan dengan benar dapat menghasilkan input yang tidak valid. Uji string untuk memastikan string valid sebelum menggunakannya dan menyediakan penangan kesalahan. Untuk informasi selengkapnya, lihat Pertimbangan Keamanan: Fitur Internasional

Metode yang disukai adalah menggunakan CompareStringW bersama dengan Microsoft Layer for Unicode (MSLU).

CompareStringWrapW harus dipanggil langsung dari Shlwapi.dll, menggunakan ordinal 45.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
 Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung
 Windows Server 2003 [hanya aplikasi desktop]
Header
Tidak ada
DLL
Shlwapi.dll (versi 5.0 atau yang lebih baru)

Lihat juga

CompareString

 

 

  • Last updated on