Функция GetFileAttributesEx извлекает атрибуты для указанного файла или каталога.
Синтаксис
BOOL GetFileAttributesEx( LPCTSTR lpFileName, // имя файла или каталога GET_FILEEX_INFO_LEVELS fInfoLevelId, // класс атрибута LPVOID lpFileInformation // информация об атрибутах ); |
Параметры
lpFileName
[in] Указатель на символьную строку с нулем в конце, которая определяет файл или каталог.Windows NT/2000/XP: В версии ANSI этой функции, число символов имени ограничивается значением MAX_PATH. Чтобы выйти за пределы этого ограничения до длины равной 32767 символам, вызовите Unicode версию функции и присоедините спереди пути "\\?\". Подробную информацию см. статье Именование файлов.
Windows 98/Me: Эта строка не должна выходить за пределы, установленные значением MAX_PATH.
fInfoLevelId
[in] Класс извлекаемой информации об атрибутах. Этим параметром может быть одно из ниже перечисленных значений.
| Значение | Предназначение |
|---|---|
| GetFileExInfoStandard | Параметр lpFileInformation структуры WIN32_FILE_ATTRIBUTE_DATA. |
lpFileInformation
[out] Указатель на буфер, который получает информацию об атрибутах. Тип информации об атрибутах, сохраняемый в этом буфере обуславливается значением fInfoLevelId.Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - не нуль.
Если функция завершается ошибкой, величина возвращаемого значения - нуль. Чтобы получить дополнительные данные об ошибке, вызовите GetLastError.
Замечания
Функция GetFileAttributes извлекает пакет информации об атрибутах в стиле файловой системы FAT. Функция GetFileAttributesEx может получить и другие наборы информации об атрибутах каталога или файла. В текущий момент, GetFileAttributeEx извлекает набор стандартных атрибутов, которые являются расширенным набором информации об атрибутах в стиле файловой системы FAT.
Windows NT Server версии 3.51 и ранее, Windows 95: Включите дополнительный заголовочный файл по имени NewAPIs.h, чтобы сделать функцию GetFileAttributesEx доступной в этих операционных системах. Функция выполняется не естественно, а оболочкой, которая использует другие родственные функции в этих системах. См. в заголовочном файле подробности использования директив предпроцессора, которые делают функцию доступной. Если Вы не имеете этого заголовочного файла, он может быть получен, путем загрузки самого последнего Windows SDK из SDK Update Site .
Смотри также
Обзор Управление файлами, Функции, используемые в управлении файлами, GetFileAttributes, SetFileAttributes
|
Размещение и совместимость GetFileAttributesEx |
||
| К |
Windows XP |
Да |
| л |
Windows 2000 Professional |
Да |
| и |
Windows NT Workstation |
Да версии 4.0 |
| е |
Windows Me |
Да |
| н |
Windows 98 |
Да |
| т |
Windows 95 |
Нет |
| С |
Windows Server 2003 |
Да |
| е | Windows 2000 Server | Да |
| р | Windows NT Server | Да версии 4.0 |
| в | ||
| е | ||
| р | ||
|
Используемая библиотека |
Kernel32.lib |
|
| Используемая DLL | - | |
| Заголовочный файл | ||
|
- объявлено в |
Winbase.h |
|
| - включено в |
Windows.h |
|
| Unicode |
Реализуется как версии Unicode и ANSI. Обратите внимание на то, что поддержка Unicode в Windows Me/98 требует программы Microsoft Layer for Unicode. |
|
| Замечания по платформе |
Не имеется |
|