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

Статья
12/21/2024

Подпрограмма 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.

Дополнительные сведения о других подпрограммах обработки строк см. в Run-Time подпрограммах библиотеки (RTL).

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	ntifs.h (include Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
правил соответствия DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

См. также

RtlEqualUnicodeString

UNICODE_STRING

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