Функция CheckNameLegalDOS8Dot3W (winbase.h)
Определяет, можно ли использовать указанное имя для создания файла в файловой системе FAT.
Синтаксис
BOOL CheckNameLegalDOS8Dot3W(
[in] LPCWSTR lpName,
[out, optional] LPSTR lpOemName,
[in] DWORD OemNameSize,
[out, optional] PBOOL pbNameContainsSpaces,
[out] PBOOL pbNameLegal
);
Параметры
[in] lpName
Имя файла в формате 8.3.
[out, optional] lpOemName
Указатель на буфер, получающий строку OEM, соответствующую Имени. Этот параметр может принимать значение NULL.
[in] OemNameSize
Размер буфера lpOemName в символах. Если lpOemName имеет значение NULL, этот параметр должен иметь значение 0 (ноль).
[out, optional] pbNameContainsSpaces
Указывает, содержит ли имя пробелы. Этот параметр может принимать значение NULL. Если имя не является допустимым именем файловой системы FAT 8.3, этот параметр не определен.
[out] pbNameLegal
Если функция выполняется успешно, этот параметр указывает, является ли имя файла допустимым именем файла FAT 8.3, если к имени файла применяется текущая кодовая страница OEM.
Возвращаемое значение
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция завершается сбоем, возвращается значение 0 (ноль). Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
С помощью этой функции можно определить, можно ли передавать имя файла в 16-разрядное приложение windows или приложение на основе MS-DOS.
В Windows 8 и Windows Server 2012 эта функция поддерживается следующими технологиями.
| Технология | Поддерживается |
|---|---|
| Протокол SMB 3.0 | Да |
| SMB 3.0 Transparent Failover (TFO) | См. примечания |
| SMB 3.0 с масштабируемыми общими папками (SO) | См. примечания |
| Файловая система общего тома кластера (CSVFS) | Да |
| Восстанавливаемая файловая система (ReFS) | Да |
Обратите внимание, что SMB 3.0 не поддерживает короткие имена в общих папках с возможностью непрерывной доступности, поэтому функция всегда возвращает ноль (сбой).
Примечание
Заголовок winbase.h определяет CheckNameLegalDOS8Dot3 как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista, Windows XP с пакетом обновления 1 (SP1) [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | winbase.h (включая Windows.h) |
| Библиотека | Kernel32.lib |
| DLL | Kernel32.dll |