FsRtlIsNameInUnUpcasedExpression 函式 (ntifs.h)

FsRtlIsNameInUnUpcasedExpression 例程會判斷 Unicode 字串是否符合指定的模式。 不同於 FsRtlIsNameInExpression 例程，如果 IgnoreCase 為 TRUE，FsRtlIsNameInUnUpcasedExpression 不會預期 Expression 在大寫中。

語法

BOOLEAN FsRtlIsNameInUnUpcasedExpression(
  PUNICODE_STRING Expression,
  PUNICODE_STRING Name,
  BOOLEAN         IgnoreCase,
  PWCH            UpcaseTable
);

參數

Expression

模式字串的指標。 可以包含通配符。 如果 IgnoreCase 為 TRUE，Expression 必須是小寫。

Name

要與模式比較之字串的指標。 不能包含通配符。

IgnoreCase

若不區分大小寫比對，則設定為 TRUE ，否則為 FALSE 。

UpcaseTable

用於不區分大小寫比對之大寫字元數據表的選擇性指標。 如果未提供此值，則會使用預設的系統大寫字元表。

傳回值

如果字串符合模式，則傳回 TRUE，否則傳回 FALSE。

備註

下列通配符可用於模式字串：

萬用字元	意義
* (星號)	比對零個或多個字元。
? (問號)	符合單一字元。
DOS_DOT	比對名稱字串以外的句號或零個字元。
DOS_QM	比對任何單一字元，或在遇到句號或名稱字串結尾時，將表達式前進到連續DOS_QMs集的結尾。
DOS_STAR	比對零或多個字元，直到遇到名稱中最後一個句點並相符為止。

注意

如果其中一個字串參數的長度為零，FsRtlIsNameInUnUpcasedExpression 會傳回 FALSE。 這表示 「*」 與 Null 字串不符。 如果這兩個參數都是 Null 字串，FsRtlIsNameInUnUpcasedExpression 會傳回 TRUE。

規格需求

需求	值
最低支援的用戶端	Windows 10 (版本 1803)
目標平台	Universal
標頭	ntifs.h
程式庫	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

另請參閱

• FsRtlIsNameInExpression