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

另请参阅