На главную

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

WIN32_FIND_DATA



The WIN32_FIND_DATA structure describes a file found by the FindFirstFile or FindNextFile function.

typedef struct _WIN32_FIND_DATA { // wfd
DWORD dwFileAttributes;
FILETIME ftCreationTime;
FILETIME ftLastAccessTime;
FILETIME ftLastWriteTime;
DWORD nFileSizeHigh;
DWORD nFileSizeLow;
DWORD dwReserved0;
DWORD dwReserved1;
TCHAR cFileName[ MAX_PATH ];
TCHAR cAlternateFileName[ 14 ];
} WIN32_FIND_DATA;


Members

dwFileAttributes

Specifies the file attributes of the file found. This member can be one or more of the following values:

Value Meaning
FILE_ATTRIBUTE_ARCHIVE
The file is an archive file. Applications use this value 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 is a directory.
FILE_ATTRIBUTE_HIDDEN
The file is hidden. It is not included in an ordinary directory listing.
FILE_ATTRIBUTE_NORMAL
The file has no other attributes set. This value 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 is read-only. Applications can read the file but cannot write to it or delete it.
FILE_ATTRIBUTE_SYSTEM
The file is part of the operating system or is used exclusively by it.
FILE_ATTRIBUTE_TEMPORARY
The file is being used for temporary storage. Applications should write to the file only if absolutely necessary. Most of the file's data remains in memory without being flushed to the media because the file will soon be deleted.


ftCreationTime

Specifies a FILETIME structure containing the time the file was created. FindFirstFile and FindNextFile report file times in Coordinated Universal Time (UTC) format. These functions set the FILETIME members to zero if the file system containing the file does not support this time member. You can use the FileTimeToLocalFileTime function to convert from UTC to local time, and then use the FileTimeToSystemTime function to convert the local time to a SYSTEMTIME structure containing individual members for the month, day, year, weekday, hour, minute, second, and millisecond.

ftLastAccessTime

Specifies a FILETIME structure containing the time that the file was last accessed. The time is in UTC format; the FILETIME members are zero if the file system does not support this time member.

ftLastWriteTime

Specifies a FILETIME structure containing the time that the file was last written to. The time is in UTC format; the FILETIME members are zero if the file system does not support this time member.

nFileSizeHigh

Specifies the high-order DWORD value of the file size, in bytes. This value is zero unless the file size is greater than MAXDWORD. The size of the file is equal to (nFileSizeHigh * MAXDWORD) + nFileSizeLow.

nFileSizeLow

Specifies the low-order DWORD value of the file size, in bytes.

dwReserved0

Reserved for future use.

dwReserved1

Reserved for future use.

cFileName

A null-terminated string that is the name of the file.

cAlternateFileName

A null-terminated string that is an alternative name for the file. This name is in the classic 8.3 (filename.ext) filename format.



Remarks

If a file has a long filename, the complete name appears in the cFileName field, and the 8.3 format truncated version of the name appears in the cAlternateFileName field. Otherwise, cAlternateFileName is empty. As an alternative, you can use the GetShortPathName function to find the 8.3 format version of a filename.

See Also

FindFirstFile, FindNextFile, FILETIME, FileTimeToLocalFileTime, FileTimeToSystemTime, GetShortPathName


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

WIN32_FIND_DATA



Структура WIN32_FIND_DATA описывает файл обнаруженный FindFirstFile или функцию FindNextFile.

typedef struct _WIN32_FIND_DATA { // wfd DWORD dwFileAttributes;
FILETIME ftCreationTime;
FILETIME ftLastAccessTime;
FILETIME ftLastWriteTime;
DWORD nFileSizeHigh;
DWORD nFileSizeLow;
DWORD dwReserved0;
DWORD dwReserved1;
TCHAR cFileName[ MAX_PATH ];
TCHAR cAlternateFileName[ 14 ];
} WIN32_FIND_DATA;


Участники

dwFileAttributes

Определяет атрибуты файла обнаруженного файла. Этот член может быть одно или более из следующего величин:

Оцените Значение 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
Файл используется для временной памяти. Приложения должны записываться в файл только если совершенно необходимо. Наиболее файловый остатки данные в памяти без сброшенное носителю поскольку файл скоро будет удален.


ftCreationTime

Определяет структуру FILETIME содержа время файл был создан. FindFirstFile И файловое время сообщения FindNextFile в течение Согласованного Универсального Времени (UTC) формата. Эти функции устанавливают участников FILETIME нуля если файловая система, содержащая файл не поддерживает на этот раз элемент. Вы можете использовать функцию FileTimeToLocalFileTime, чтобы преобразовываться от UTC до локального времени, затем использовать функцию FileTimeToSystemTime, чтобы преобразовывать локальное время в структуру SYSTEMTIME, содержащую индивидуальных участников в течение месяца, дня, года, дня недели, час, минута, секунда, и миллисекунды.

ftLastAccessTime

Определяет структуру FILETIME содержа время, что файл был последним доступным. Время - в формате UTC; участники FILETIME являются нулем если файловая система не поддерживает на этот раз элемент.

ftLastWriteTime

Определяет структуру FILETIME содержа время, что файл последний раз был записан, чтобы. Время - в формате UTC; участники FILETIME являются нулем если файловая система не поддерживает на этот раз элемент.

nFileSizeHigh

Определяет старшую величину DWORD файлового размера, в байтах. Эта величина является нулем если файловый размер не больше, чем MAXDWORD. Размер файла равняется (nFileSizeHigh * MAXDWORD) + nFileSizeLow.

nFileSizeLow

Определяет младшую величину DWORD файлового размера, в байтах.

dwReserved0

Зарезервированное для будущего использования.

dwReserved1

Зарезервированное для будущего использования.

cFileName

Недействительный расторгнутая строка, которая - имя файла.

cAlternateFileName

Недействительный расторгнутая строка, которая - альтернатива называет в честь файла. Это зовут в классике 8.3 (filename.ext) filename формат.



Замечания

Если файл имеет длинный filename, полное имя появляется в области cFileName, и 8.3 форматов исключивших версию имени появляется в области cAlternateFileName. В противном случае, cAlternateFileName пустой. Как альтернатива, Вы можете использовать функцию GetShortPathName, чтобы находить 8.3 версий формата filename.

Смотри Также

FindFirstFile, FindNextFile, FILETIME, FileTimeToLocalFileTime, FileTimeToSystemTime, GetShortPathName


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