Функция 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, соответствующую строке Юникода в Name.
[out, optional] NameContainsSpaces
Указатель на необязательное значение BOOLEAN, которое получает TRUE, если строка в Name содержит внедренные пробелы, FALSE в противном случае. Это значение допустимо, только если RtlIsNameLegalDOS8Dot3 возвращает TRUE.
Возвращаемое значение
RtlIsNameLegalDOS8Dot3 возвращает TRUE, если строка Name является юридическим коротким именем файла (8.3), FALSE в противном случае.
Замечания
RtlIsNameLegalDOS8Dot3 преобразует строку Юникода в Name с помощью кодовой страницы OEM, установленной в качестве текущей системной кодовой страницы во время загрузки системы, и преобразует переведенную строку в верхний регистр. (Если вызывающий объект предоставил буфер в OemName, этот буфер получает полученную строку.) RtlIsNameLegalDOS8Dot3 проверяет правильное форматирование имени 8.3 и содержит только юридические символы.
Дополнительные сведения о других подпрограммах обработки строк см. в Run-Time подпрограммах библиотеки (RTL).
Если блок памяти Name не поддерживается, вызывающий объект может работать в IRQL <= DISPATCH_LEVEL. В противном случае вызовы RtlIsNameLegalDOS8Dot3 должны выполняться в IRQL < DISPATCH_LEVEL.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| заголовка | ntifs.h (include Ntifs.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | См. раздел "Примечания". |