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

Статья
02/29/2024

Подпрограмма RtlIsNameLegalDOS8Dot3 определяет, представляет ли заданное имя допустимое короткое (8.3) имя файла.

Синтаксис

NTSYSAPI BOOLEAN RtlIsNameLegalDOS8Dot3(
  [in]            PCUNICODE_STRING Name,
  [in, out]       POEM_STRING      OemName,
  [out, optional] PBOOLEAN         NameContainsSpaces
);

Параметры

[in] Name

Указатель на строку Юникода, содержащую имя файла.

[in, out] OemName

Указатель на дополнительный буфер, выделенный вызывающим абонентом, который получает подсчитываемую строку OEM, соответствующую строке Юникода в поле Имя.

[out, optional] NameContainsSpaces

Указатель на необязательное значение BOOLEAN, которое получает значение TRUE , если строка в name содержит внедренные пробелы, в противном случае — FALSE . Это значение допустимо, только если RtlIsNameLegalDOS8Dot3 возвращает значение TRUE.

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

RtlIsNameLegalDOS8Dot3 возвращает значение TRUE , если строка в поле Name является юридическим коротким (8.3) именем файла, в противном случае — FALSE .

RtlIsNameLegalDOS8Dot3 преобразует строку Юникода в поле Имя , используя кодовую страницу OEM, которая была установлена в качестве текущей системной кодовой страницы во время загрузки системы, и преобразует переведенную строку в верхний регистр. (Если вызывающий объект предоставил буфер по адресу OemName, этот буфер получает итоговую строку.) RtlIsNameLegalDOS8Dot3 проверяет, является ли имя правильно отформатированным именем версии 8.3 и содержит только юридические символы.

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

Если блок памяти в name не загружен, вызывающий объект может выполняться в IRQL <= DISPATCH_LEVEL. В противном случае вызывающие компоненты RtlIsNameLegalDOS8Dot3 должны выполняться на DISPATCH_LEVEL IRQL < .

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	ntifs.h (включая Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	См. раздел "Примечания".

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

OEM_STRING

RtlGenerate8dot3Name

UNICODE_STRING

Share via