На главную

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 | Скачать Вниз

GetFileAttributes



The GetFileAttributes function returns attributes for a specified file or directory.

DWORD GetFileAttributes(

LPCTSTR lpFileName // address of the name of a file or directory
);


Parameters

lpFileName

Points to a null-terminated string that specifies the name of a file or directory.

Windows NT:

There is a default string size limit for paths of MAX_PATH characters. This limit is related to how the GetFileAttributes 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 GetFileAttributes and prepending "\\?\" to the path. The "\\?\" tells the function to turn off path parsing; it lets paths longer than MAX_PATH be used with GetFileAttributesW. This 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\bill_g_1\hotstuff\coolapps" is seen as "\\bill_g_1\hotstuff\coolapps".

Windows 95:

The lpFileName string must not exceed MAX_PATH characters. Windows 95 does not support the "\\?\" prefix.



Return Values

If the function succeeds, the return value contains the attributes of the specified file or directory.
If the function fails, the return value is 0xFFFFFFFF. To get extended error information, call GetLastError.
The attributes can be one or more of the following values:

Value Meaning
FILE_ATTRIBUTE_ARCHIVE The file or directory is an archive file or directory. Applications use this flag to mark files for backup or removal.
FILE_ATTRIBUTE_COMPRESSED The file or directory is compressed. For a file, this means that all of the data in the file is compressed. For a directory, this means that compression is the default for newly created files and subdirectories.
FILE_ATTRIBUTE_DIRECTORY The "file or directory" is a directory.
FILE_ATTRIBUTE_HIDDEN The file or directory is hidden. It is not included in an ordinary directory listing.
FILE_ATTRIBUTE_NORMAL The file or directory has no other attributes set. This attribute is valid only if used alone.
FILE_ATTRIBUTE_OFFLINE The data of the file is not immediately available. Indicates that the file data has been physically moved to offline storage.
FILE_ATTRIBUTE_READONLY The file or directory is read-only. Applications can read the file but cannot write to it or delete it. In the case of a directory, applications cannot delete it.
FILE_ATTRIBUTE_SYSTEM The file or directory is part of, or is used exclusively by, the operating system.
FILE_ATTRIBUTE_TEMPORARY The file is being used for temporary storage. File systems attempt to keep all of the data in memory for quicker access rather than flushing the data back to mass storage. A temporary file should be deleted by the application as soon as it is no longer needed.


See Also

DeviceIOControl, FindFirstFile, FindNextFile, SetFileAttributes


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

GetFileAttributes



Функция GetFileAttributes возвращает атрибутам для определенного файла или директория.

DWORD GetFileAttributes(

АДРЕС LPCTSTR lpFileName // имени файла или директория
);


Параметры

lpFileName

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

Окно NT:

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

Окно 95:

Строка lpFileName не должна превышать символы MAX_PATH. Окно 95 не поддерживает "\\?\" префикс.



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

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

Значение Величины
FILE_ATTRIBUTE_ARCHIVE файл или директорий - архивный файл или директорий. Приложения используют этот флаг, чтобы выделять файлам для копии или удаления.
FILE_ATTRIBUTE_COMPRESSED файл или директорий сжат. Для файла, это означает, что все данные в файле сжаты. Для директория, это означает, что сжатие по умолчанию для вновь созданных файлов и подкаталогов.
FILE_ATTRIBUTE_DIRECTORY "файл или директорий" является директорием.
FILE_ATTRIBUTE_HIDDEN файл или директорий исчезнут. Это не включено в обычный листинг директория.
FILE_ATTRIBUTE_NORMAL файл или директорий не был установлен другие атрибуты. Этот атрибут - в силе только если использовано только.
FILE_ATTRIBUTE_OFFLINE данные файла не немедленно доступно. Указывает, что файловые данные физически перемещены на offline память.
FILE_ATTRIBUTE_READONLY файл или директорий только для чтения. Приложения могут прочитать файл но не могут записаться этому или удалять это. В случае директория, приложения не могут удалить это.
FILE_ATTRIBUTE_SYSTEM файл или директорий является частью, или используется исключительно, операционная система.
FILE_ATTRIBUTE_TEMPORARY файл используется для временной памяти. Файловые системы пытаются держать все данные в памяти для quicker доступа а не краски данных, чтобы массировать память. Временный файл должен быть удален приложением как только он не будет больше не нужно.


Смотри Также

DeviceIOControl, FindFirstFile, FindNextFile, SetFileAttributes


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz