FsRtlIsNameInUnUpcasedExpression 函式 (ntifs.h)
FsRtlIsNameInUnUpcasedExpression 例程會判斷 Unicode 字串是否符合指定的模式。 不同於 FsRtlIsNameInExpression 例程,FsRtlIsNameInUnUpcasedExpression 若 IgnoreCase 為 TRUE,則表達式不會在大寫。
語法
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) |
目標平臺 | 普遍 |
標頭 | ntifs.h |
連結庫 | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |