Функция 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. Это означает, что "*" не соответствует пустой строке. Если оба параметра являются пустыми строками, FsRtlIsNameInUnUpcasedExpression возвращает значение TRUE.

Требования

Требование Значение
Минимальная версия клиента Windows 10 (версия 1803)
Целевая платформа Универсальное
Верхняя часть ntifs.h
Библиотека NtosKrnl.exe
IRQL PASSIVE_LEVEL

См. также раздел