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

Подпрограмма FsRtlAreNamesEqual определяет, равны ли две строки Юникода.

Синтаксис

BOOLEAN FsRtlAreNamesEqual(
  [in]           PCUNICODE_STRING ConstantNameA,
  [in]           PCUNICODE_STRING ConstantNameB,
  [in]           BOOLEAN          IgnoreCase,
  [in, optional] PCWCH            UpcaseTable
);

Параметры

[in] ConstantNameA

Указатель на первую строку. Не может содержать подстановочные знаки.

[in] ConstantNameB

Указатель на вторую строку. Не может содержать подстановочные знаки.

[in] IgnoreCase

Установите значение TRUE для сопоставления без учета регистра, в противном случае — FALSE .

[in, optional] UpcaseTable

Необязательный указатель на таблицу символов верхнего регистра для сопоставления без учета регистра. Если это значение не указано, используется системная таблица символов верхнего регистра по умолчанию.

Возвращаемое значение

FsRtlAreNamesEqual возвращает значение TRUE , если две строки Юникода совпадают, в противном случае — FALSE .

Комментарии

Таблица, на которую указывает UpcaseTable , представляет собой массив символов Юникода в верхнем регистре, индексируемых символом Юникода для преобразования в верхний регистр. Массив должен содержать записи для всех символов, которые являются допустимыми в именах файлов.

Сопоставление без учета регистра выполняется путем преобразования обеих строк в верхний регистр перед их сравнением. Таким образом, значение UpcaseTable , если указано, используется только в том случае, если IgnoreCase имеет значение TRUE.

При сбое выделения пула FsRtlAreNamesEqual вызывает исключение STATUS_NO_MEMORY.

Сведения о других процедурах обработки строк см. в статье Подпрограммы библиотеки времени выполнения (RTL).

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть ntifs.h (включая Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Правила соответствия DDI HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

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

RtlEqualUnicodeString

UNICODE_STRING