FsRtlIsNameInUnUpcasedExpression 函数 (ntifs.h)

FsRtlIsNameInUnUpcasedExpression 例程确定 Unicode 字符串是否与指定的模式匹配。 与 FsRtlIsNameInExpression 例程不同，如果 IgnoreCase 为 TRUE，FsRtlIsNameInUnUpcasedExpression 不期望表达式为大写。

语法

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
Library	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

另请参阅

• FsRtlIsNameInExpression