Функция GetFileAttributes извлекает установленные атрибуты в стиле файловой системы FAT указанного файла или каталога.
Чтобы получить дополнительные информацию об атрибутах, используйте функцию GetFileAttributesEx.
Синтаксис
DWORD GetFileAttributes( LPCTSTR lpFileName // имя файла или каталога ); |
Параметры
lpFileName
[in] Указатель на символьную строку с нулем в конце, которая определяет имя файла или каталога.Windows NT/2000/XP: В версии ANSI этой функции, число символов имени ограничивается значением MAX_PATH. Чтобы выйти за пределы этого ограничения до длины равной 32767 символам, вызовите Unicode версию функции и присоедините спереди пути "\\?\". Подробную информацию см. статье Именование файлов.
Windows 95/98/Me: Эта строка не должна выходить за пределы, установленные значением MAX_PATH.
Возвращаемые значения
Если функция завершается успешно, возвращаемое значение содержит атрибуты указанного файла или каталога.
Если функция завершается ошибкой, возвращаемое значение - INVALID_FILE_ATTRIBUTES. Чтобы получить дополнительные данные об ошибке, вызов GetLastError.
Атрибуты могут состоять из одного или нескольких нижеследующих значений.
| Атрибут | Предназначение |
|---|---|
| FILE_ATTRIBUTE_ARCHIVE | Файл или каталог - архивные. Приложения используют этот атрибут, чтобы отметить файлы для резервного копирования или перемещения. |
| FILE_ATTRIBUTE_COMPRESSED | Файл или каталог сжатые. Для файла, это означает, что все данные в файле сжимаются. Для каталога, это означает, что сжатие является значением по умолчанию для недавно созданных файлов и вложенных каталогов. |
| FILE_ATTRIBUTE_DEVICE | Зарезервировано; не используется. |
| FILE_ATTRIBUTE_DIRECTORY | Дескриптор идентифицирует каталог. |
| FILE_ATTRIBUTE_ENCRYPTED | Файл или каталог - зашифрованные. Для файла, это означает, что все потоки данных в файле зашифрованы. Для каталога, это означает, что шифрование - это значение по умолчанию для недавно созданных файлов и вложенных каталогов. |
| FILE_ATTRIBUTE_HIDDEN | Файл или каталог скрытые. Они не включается в обычный список каталога. |
| FILE_ATTRIBUTE_NORMAL | Файл или каталог не имеют других установленных атрибутов. Этот атрибут допустим только в том случае, если используется как единственный. |
| FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | Файл не будет индексирован содержащим индексы модулем обслуживания. |
| FILE_ATTRIBUTE_OFFLINE | Данные файла доступны не сразу. Этот атрибут указывает, что данные файла были физически перемещены, чтобы сохраняться автономно. Этот атрибут используется программами Удаленного хранилища, иерархического управления памятью. Приложения не должны произвольно изменять этот атрибут. |
| FILE_ATTRIBUTE_READONLY | Файл или каталог только для чтения. Приложения могут читать этот файл, но не могут записать в него или удалить его. Что касается каталога, приложения не могут удалить его. |
| FILE_ATTRIBUTE_REPARSE_POINT | Файл или каталог имеет связанную точку повторной обработки. |
| FILE_ATTRIBUTE_SPARSE_FILE | Файл - разреженный файл. |
| FILE_ATTRIBUTE_SYSTEM | Файл или каталог - частично или исключительно используются операционной системой. |
| FILE_ATTRIBUTE_TEMPORARY | Файл используется для временного хранения. Файловые системы избегают писать обратно данные на запоминающее устройство большой емкости, если доступна достаточная кэш-память, потому что приложение часто удаляет временный файл вскоре после того, как дескриптор закрывается. В этом случае, система может полностью отменить запись данных. В противном случае, данные, должны быть записаны после закрытия дескриптора. |
Замечания
Когда функция GetFileAttributes вызывается в каталоге, содержащем точку повторной обработки тома, возвращаемые атрибуты файла - такие же, что и у каталога, где точка повторной обработки тома установлена, но не такие же, как у корневого каталога в целевом монтируемом томе. Чтобы получить атрибуты файла повторной обработки тома, вызовите функцию GetVolumeNameForVolumeMountPoint, чтобы получить имя целевого тома. Затем используйте итоговое имя в вызове функции GetFileAttributes. Результатами должны быть атрибуты корневого каталога у целевого тома.
Код примера
Пример, см. в статье Получение и изменение атрибутов файла.
Смотри также
Обзор Управление файлами, Функции, используемые в управлении файлами, DeviceIoControl, FindFirstFile, FindNextFile, GetFileAttributesEx, SetFileAttributes
|
Размещение и совместимость GetFileAttributes |
||
| К |
Windows XP |
Да |
| л |
Windows 2000 Professional |
Да |
| и |
Windows NT Workstation |
Да |
| е |
Windows Me |
Да |
| н |
Windows 98 |
Да |
| т |
Windows 95 |
Да |
| С |
Windows Server 2003 |
Да |
| е | Windows 2000 Server | Да |
| р | Windows NT Server | Да |
| в | ||
| е | ||
| р | ||
|
Используемая библиотека |
Kernel32.lib |
|
| Используемая DLL | - | |
| Заголовочный файл | ||
|
- объявлено в |
Winbase.h |
|
| - включено в |
Windows.h |
|
| Unicode |
Реализуется как версии Unicode и ANSI. Обратите внимание на то, что поддержка Unicode в Windows Me/98/95 требует программы Microsoft Layer for Unicode. |
|
| Замечания по платформе |
Не имеется |
|