FsRtlIsNameInUnUpcasedExpression 函数 (ntifs.h)
FsRtlIsNameInUnUpcasedExpression 例程确定 Unicode 字符串是否与指定的模式匹配。 与 FsRtlIsNameInExpression 例程不同,FsRtlIsNameInUnUpcasedExpression 如果 IgnoreCase 为 TRUE,则表达式不会处于大写。
语法
BOOLEAN FsRtlIsNameInUnUpcasedExpression(
PUNICODE_STRING Expression,
PUNICODE_STRING Name,
BOOLEAN IgnoreCase,
PWCH UpcaseTable
);
参数
Expression
指向模式字符串的指针。 可以包含通配符。 如果 IgnoreCase 为 TRUE,则表达式必须为小写。
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 |