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

Статья
12/21/2024

Процедура FsRtlIsHpfsDbcsLegal определяет, является ли указанная строка ANSI или двухбайтовым набором символов (DBCS) юридическим именем файла HPFS.

Синтаксис

BOOLEAN FsRtlIsHpfsDbcsLegal(
  [in] ANSI_STRING DbcsName,
  [in] BOOLEAN     WildCardsPermissible,
  [in] BOOLEAN     PathNamePermissible,
  [in] BOOLEAN     LeadingBackslashPermissible
);

Параметры

[in] DbcsName

Указатель на строку для проверки.

[in] WildCardsPermissible

Задайте значение TRUE, если подстановочные знаки считаются законными, значение FALSE в противном случае.

[in] PathNamePermissible

Задайте значение TRUE, если DbcsName может быть полным именем пути, содержащим символы обратной косой черты, значение FALSE, если оно может быть только именем файла.

[in] LeadingBackslashPermissible

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

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

Подпрограмма FsRtlIsHpfsDbcsLegal возвращает значение TRUE, если строка является юридическим именем файла HPFS, в противном случае — FALSE.

Замечания

Подпрограмма FsRtlIsHpfsDbcsLegal определяет, соответствует ли указанное имя файла правилам, зависящим от HPFS, для имен юридических файлов. Эта подпрограмма проверяет имя файла или, если PathNamePermissible указывается как TRUE, является ли имя всего пути юридическим именем HPFS.

Имена файлов HPFS должны соответствовать следующим правилам:

Следующие символы являются незаконными в именах файлов HPFS: 0x0000 - 0x001F, " (кавычки), / (косая черта), : (двоеточие), < (знак меньше), > (знак больше) ? (вопросительный знак), | (вертикальная полоса или труба), * (звездочка)
Имя файла HPFS не может заканчиваться в течение периода или пробела. Например, файлы "foo" и "foo". являются незаконными, а "foo", "foo" и "foo.bar.foo" являются законными.
Имя файла HPFS может содержать не более 255 байт.
Имена файлов HPFS сохраняют регистр, но не учитывают регистр. Имена файлов строчных регистров не преобразуются в верхний регистр автоматически. Однако случай игнорируется в сравнениях имен файлов.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000
целевая платформа	Всеобщий
заголовка	ntifs.h (include FltKernel.h, Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

См. также

ANSI_STRING

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