Функция RtlIsNameLegalDOS8Dot3 (ntifs.h)
Подпрограмма 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 | См. раздел "Примечания". |