Поделиться через

Функция FsRtlIsNameInUnUpcasedExpression (ntifs.h)

  • Статья

Подпрограмма FsRtlIsNameInUnUpcasedExpression определяет, соответствует ли строка Юникода указанному шаблону. В отличие отподпрограммы 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, FsRtlIsNameInUnUpcasedExpression возвращает ЗНАЧЕНИЕ TRUE.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 10 (версия 1803)
целевая платформа Всеобщий
заголовка ntifs.h
библиотеки NtosKrnl.exe
IRQL PASSIVE_LEVEL

См. также