On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

GetFileAttributesEx

[New - Windows NT]

The GetFileAttributesEx function obtains attribute information about a specified file or directory.
This function is similar to the GetFileAttributes function. GetFileAttributes returns a set of FAT-style attribute information. GetFileAttributesEx is designed to obtain other sets of file or directory attribute information. Currently, GetFileAttributeEx obtains a set of standard attributes that is a superset of the FAT-style attribute information.

BOOL GetFileAttributesEx(

LPCTSTR lpFileName, // pointer to string that specifies a file or directory
GET_FILEEX_INFO_LEVELS fInfoLevelId, // value that specifies the type of attribute information to obtain
LPVOID lpFileInformation // pointer to buffer to receive attribute information
);

Parameters

lpFileName

Pointer to a null-terminated string that specifies a file or directory.

By default, this string is limited to MAX_PATH characters. The limit is related to how the GetFileAttributesEx function parses paths. An application can transcend this limit and send in paths longer than MAX_PATH characters by calling the wide (W) version of GetFileAttributesEx and prepending "\\?\" to the path. The "\\?\" tells the function to turn off path parsing. This technique also works with UNC names. The "\\?\" is ignored as part of the path. For example, "\\?\C:\myworld\private" is seen as "C:\myworld\private", and "\\?\UNC\peanuts\hotstuff\coolapps" is seen as "\\peanuts\hotstuff\coolapps".

fInfoLevelId

Enumeration type value that specifies the set of attribute information to obtain.
You can use the following value for fInfoLevelId:

Value Meaning
GetFileExInfoStandard The function obtains a standard set of attribute information. The data is returned in a WIN32_FILE_ATTRIBUTE_DATA structure.

Future releases of Win32-based operating systems and extensions may define other values for the GET_FILEEX_INFO_LEVELS enum type.

lpFileInformation

Pointer to a buffer that receives the attribute information.
The type of attribute information stored into this buffer is determined by the value of fInfoLevelId, as follows:

Value of fInfoLevelId Structure Stored into *lpFileInformation
GetFileExInfoStandard WIN32_FILE_ATTRIBUTE_DATA.

Return Values

If the function succeeds, the return value is a nonzero value.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

See Also

GetFileAttributes, SetFileAttributes, WIN32_FILE_ATTRIBUTE_DATA

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

GetFileAttributesEx

[Новый - Windows NT]

Функция GetFileAttributesEx получает вспомогательной информации об определенном файле или директории.
Эта функция подобная функции GetFileAttributes. GetFileAttributes ВОЗВРАЩАЕТ установку ЖИРНОЙ-вспомогательной информации стиля. GetFileAttributesEx ПРЕДНАЗНАЧЕН получать другие комплекты файловой или вспомогательной информации директория. К настоящему времени, GetFileAttributeEx получает установку стандартных атрибутов, которые - расширенный набор ЖИРНОЙ-вспомогательной информации стиля.

BOOL GetFileAttributesEx(

LPCTSTR lpFileName, // УКАЗАТЕЛЬ, чтобы нанизывать, что определяет файл или директорий GET_FILEEX_INFO_LEVELS fInfoLevelId, // величина, что определяет тип вспомогательной информации, чтобы получать указатель LPVOID lpFileInformation //, чтобы буферизоваться, чтобы получать вспомогательную информацию
);

Параметры

lpFileName

Указатель в недействительный расторгнутую строку, которая определяет файл или директорий.

По умолчанию, эта строка ограниченная символами MAX_PATH. Предел обусловливается, чтобы как функциональные пути грамматических разборов GetFileAttributesEx. Приложение может превзойти этот предел и посылаться в пути более длинные чем символы MAX_PATH вызывая широкую версию (W) GetFileAttributesEx и добавляя "\\?\" в путь. "\\?\" Сообщает функцию, чтобы выключать синтаксический анализ пути. Эта техника также работает с именами UNC. "\\?\" Проигнорирован как часть пути. Например, "\\?\C:\myworld\private" виден как "C:\myworld\private", и "\\?\UNC\peanuts\hotstuff\coolapps" виден как "\\peanuts\hotstuff\coolapps".

fInfoLevelId

Величина типа Перечисления, которая определяет установку вспомогательной информации, чтобы получать.
Вы можете использовать следующее величины для fInfoLevelId:

Значение Величины
GetFileExInfoStandard ФУНКЦИЯ получает стандартный комплект вспомогательной информации. Данные возвращаны в структуру WIN32_FILE_ATTRIBUTE_DATA.

Будущие версии базирующихся операционных систем Win32 и расширения могут определить другие величины для GET_FILEEX_INFO_LEVELS enum типа.

lpFileInformation

Указатель в буфер, который получает вспомогательную информацию.
Тип вспомогательной информации загруженной в этот буфер определен величиной fInfoLevelId, следующим образом:

Величина Структуры fInfoLevelId Загружала в *lpFileInformation GetFileExInfoStandard WIN32_FILE_ATTRIBUTE_DATA.

Обратные Величины

Если функция добивается успеха, обратная величина является ненулевой величиной.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Смотри Также

GetFileAttributes, SetFileAttributes, WIN32_FILE_ATTRIBUTE_DATA

Используются технологии uCoz