Fungsi FsRtlAreNamesEqual (ntifs.h)

  • Artikel

Rutinitas FsRtlAreNamesEqual menentukan apakah dua string Unicode sama.

Sintaks

BOOLEAN FsRtlAreNamesEqual(
  [in]           PCUNICODE_STRING ConstantNameA,
  [in]           PCUNICODE_STRING ConstantNameB,
  [in]           BOOLEAN          IgnoreCase,
  [in, optional] PCWCH            UpcaseTable
);

Parameter

[in] ConstantNameA

Penunjuk ke string pertama. Tidak boleh berisi karakter kartubebas.

[in] ConstantNameB

Penunjuk ke string kedua. Tidak boleh berisi karakter kartubebas.

[in] IgnoreCase

Atur ke TRUE untuk pencocokan tidak peka huruf besar/kecil, FALSE jika tidak.

[in, optional] UpcaseTable

Penunjuk opsional ke tabel karakter huruf besar yang akan digunakan untuk pencocokan yang tidak peka huruf besar/kecil. Jika nilai ini tidak disediakan, tabel karakter huruf besar sistem default akan digunakan.

Nilai kembali

FsRtlAreNamesEqual mengembalikan TRUE jika dua string Unicode cocok, FALSE jika tidak.

Keterangan

Tabel yang ditunjukkan oleh UpcaseTable adalah array karakter Unicode huruf besar, diindeks oleh karakter Unicode yang akan dikonversi menjadi huruf besar. Array harus berisi entri untuk semua karakter yang legal dalam nama file.

Pencocokan tidak sensitif huruf besar/kecil dilakukan dengan mengonversi kedua string menjadi huruf besar sebelum dibandingkan. Dengan demikian, nilai UpcaseTable, jika disediakan, hanya digunakan jika IgnoreCaseADALAH TRUE.

Jika kegagalan alokasi kumpulan terjadi, FsRtlAreNamesEqual akan memunculkan pengecualian STATUS_NO_MEMORY.

Untuk informasi tentang rutinitas penanganan string lainnya, lihat Rutinitas Pustaka Run-Time (RTL).

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header ntifs.h (termasuk Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Lihat juga

RtlEqualUnicodeString

UNICODE_STRING