Delphi. WinAPI тип TWin32FindData

TWin32FindData

unit Windows

Описание:

TWin32FindData = TWin32FindDataA;
TWin32FindDataA = _WIN32_FIND_DATAA;
 

  _WIN32_FIND_DATAA = record

    dwFileAttributes: DWORD;
    ftCreationTime: TFileTime;
    ftLastAccessTime: TFileTime;
    ftLastWriteTime: TFileTime;
    nFileSizeHigh: DWORD;
    nFileSizeLow: DWORD;
    dwReserved0: DWORD;
    dwReserved1: DWORD;
    cFileName: array[0..MAX_PATH - 1] of AnsiChar;
    cAlternateFileName: array[0..13] of AnsiChar;
  end;

Комментарии:

Эта структура описывает файл, найденый API функциями FindFirstFile или FindNextFile. В этом же формате параметр FindData (только для Windows) в TSearchRec содержит дополнительную информацию о файле, найденом функциями FindFirst или FindNext.

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

Константа	Значение	Описание
FILE_ATTRIBUTE_ARCHIVE	$00000020	Архивный файл. Приложения используют этот аттрибут для пометки файлов для резервного копирования или перемещения.
FILE_ATTRIBUTE_COMPRESSED	$00000800	Файл или директория сжаты. Для файла это означает, что все данные в файле сжаты. Для директории это означает, что по умолчанию все вновь создаваемые файлы и поддиректории будут подвергаться сжатию.
FILE_ATTRIBUTE_DIRECTORY	$00000010	Файл является директорией
FILE_ATTRIBUTE_HIDDEN	$00000002	Файл является скрытым. Он не включается в обычный список директории.
FILE_ATTRIBUTE_NORMAL	$00000080	Файл не имеет никаких других установленых аттрибутов. Это значение обосновано только если используется отдельно.
FILE_ATTRIBUTE_OFFLINE	$00001000	Данные файла в настоящий момент не доступны. Показывает что данные файла были физически перемещены для offline storage
FILE_ATTRIBUTE_READONLY	$00000001	Фай только для чтения. Приложения могут читать файл, но не могут изменять его или удалять.
FILE_ATTRIBUTE_SYSTEM	$00000004	Системный файл. Означает, что этот файл является частью операционной системы или испльзуется исключительно операционной системой.
FILE_ATTRIBUTE_TEMPORARY	$00000100	Файл используется для временного сохранения данных. Приложения должны записывать в этот файл только если это абсолютно необходимо. Большинство данных файла в процессе работы остаются в оперативной памяти без сохранения на диске потому что вскоре будут удалены из нее.

ftCreationTime содержит время создания файла в формате TFileTime. Функции FindFirstFile и FindNextFile возвращают время в формате Coordinated Universal Time (UTC) [универсальное глобальное время (по Гринвичу)]. Если файловая система не поддерживает сохранение этих данных, то эти функции устанавливают поля TFileTime в ноль.Вы можете использовать функцию FileTimeToLocalFileTime для преобразования UTC в местное время, а затем использовать функцию FileTimeToSystemTime для преобразования местного времени в SYSTEMTIME структуру, содержащую отдельные поля для месяца, дня, года, дня недели, часов, минут, секунд и милисекунд.

ftLastAccessTime содержит время последнего обращения к файлу в формате TFileTime. Время в UTC формате. Если файловая система не поддерживает сохранение этих данных, то поля TFileTime устанавливаются в ноль.

ftLastWriteTime содержит время последнего изменения файла в формате TFileTime. Время в UTC формате. Если файловая система не поддерживает сохранение этих данных, то поля TFileTime устанавливаются в ноль.

nFileSizeHigh старшее DWORD значение размера файла, в байтах. Это значение равно нулю до тех пор пока размер файла не станет больше чем MAXWORD. Размер файла равен (nFileSizeHigh * MAXDWORD) + nFileSizeLow . (MAXDWORD = DWORD($FFFFFFFF))

nFileSizeLow младшее DWORD значение размера файла, в байтах.

dwReserved0 зарезервировано на будущее.

dwReserved1 зарезервировано на будущее.

cFileName это стpока, заканчиваяющаяся пустым символом, котоpая содеpжит имя файла.

cAlternateFileName это стpока, заканчиваяющаяся пустым символом, котоpая содеpжит имя файла в классической 8.3 (имя.расширение) форме.

Примечание:

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

Платонов А.Н.
18.03.2009

Список литературы:

Delphi 7 Help
Delphi 7 Win32 Programmer's Reference
Delphi 7 Windows.pas

На главную

Структуры WinAPI

TWin32FindData