14 сент. 2010 г.

GetFileAttributesEx

Функция GetFileAttributesEx получает атрибуты указанного файла или директории.

BOOL GetFileAttributesEx(
  LPCTSTR lpFileName,
  GET_FILEEX_INFO_LEVELS fInfoLevelId,
  LPVOID lpFileInformation
);

Параметры:
lpFileNameАдрес нульзаканчивающейся строки, которая определяет имя файла или директории.

В ANSI-версия этой функции, имя ограничено в MAX_PATH символов. Для увеличения этого предела до 32,767 широких символов, вызывайте Unicode-версию функции, добавив к пути "\\?\".

Windows Me/98:  Эта строка не должна превышать MAX_PATH символов.
fInfoLevelIdКласс получаемой информации об атрибутах.

Этот параметр может иметь только одно значение GetFileExInfoStandard, которое определяет, что параметр lpFileInformation содержит адрес структуры WIN32_FILE_ATTRIBUTE_DATA.
lpFileInformationАдрес буфера, который получает информацию об атрибутах.

Тип информации об атрибутах, которая сохраняется в этот буфер, определяется значением fInfoLevelId.

Возвращаемые значения:
Если вызов функции успешен, возвращается ненулевое значение.

При ошибке возвращается ноль. Для получения дополнительной информации об ошибке, вызывайте GetLastError.
Замечания:
Функция GetFileAttribute получает набор атрибутов для файловой системы FAT. GetFileAttributesEx может получить другие наборы атрибутов файла или директории. GetFileAttributesEx получает набор стандартных атрибутов, которые переопределяет набор атрибутов для файловой системы FAT.

Если путь указывает символическую ссылку, функция возвращает атрибуты для этой символической ссылки.
Смотрите также:
GetFileAttributes, SetFileAttributes