Fungsi FsRtlIsNameInExpression (ntifs.h)

Rutinitas FsRtlIsNameInExpression menentukan apakah string Unicode cocok dengan pola yang ditentukan.

Sintaks

BOOLEAN FsRtlIsNameInExpression(
  [in]           PUNICODE_STRING Expression,
  [in]           PUNICODE_STRING Name,
  [in]           BOOLEAN         IgnoreCase,
  [in, optional] PWCH            UpcaseTable
);

Parameter

[in] Expression

Penunjuk ke string pola. Dapat berisi karakter kartubebas. Jika IgnoreCaseTRUE, Ekspresi harus huruf besar.

[in] Name

Penunjuk ke string yang akan dibandingkan dengan pola. 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 tidak peka huruf besar/kecil. Jika nilai ini tidak disediakan, tabel karakter huruf besar sistem default digunakan.

Mengembalikan nilai

FsRtlIsNameInExpression mengembalikan TRUE jika string cocok dengan pola, FALSE jika tidak.

Keterangan

Karakter kartubebas berikut dapat digunakan dalam string pola.

Katakter kartubebas Makna
* (tanda bintang) Cocok dengan nol karakter atau lebih.
? (tanda tanya) Cocok dengan satu karakter.
DOS_DOT Cocok dengan karakter titik atau nol di luar string nama.
DOS_QM Mencocokkan karakter tunggal atau, setelah menemukan titik atau akhir string nama, memajukan ekspresi ke akhir kumpulan DOS_QMs yang berdamai.
DOS_STAR Mencocokkan nol atau lebih karakter hingga menemukan dan mencocokkan final. dalam nama.

Dalam kondisi sumber daya rendah, FsRtlIsNameInExpression dapat meningkatkan pengecualian terstruktur dengan kode STATUS_NO_MEMORY, yang harus ditangani oleh penelepon. Untuk informasi selengkapnya, lihat Penanganan Pengecualian Terstruktur.

Catatan

Jika hanya salah satu parameter string yang memiliki panjang nol, FsRtlIsNameInExpression mengembalikan FALSE. Ini berarti bahwa "*" tidak cocok dengan string null.

Jika kedua parameter adalah string null, FsRtlIsNameInExpression mengembalikan TRUE.

Persyaratan

   
Klien minimum yang didukung Rutinitas ini tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform Universal
Header ntifs.h (termasuk FltKernel.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Lihat juga

FsRtlIsDbcsInExpression

UNICODE_STRING