На главную
Структуры WinAPI
Тип:

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


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

    1. Delphi 7 Help
    2. Delphi 7 Win32 Programmer's Reference
    3. Delphi 7 Windows.pas


    Hosted by uCoz