структура WIN32_FIND_DATAA (minwinbase.h)

Статья
03/05/2024

Содержит сведения о файле, который найден функцией FindFirstFile, FindFirstFileEx или FindNextFile .

Синтаксис

typedef struct _WIN32_FIND_DATAA {
  DWORD    dwFileAttributes;
  FILETIME ftCreationTime;
  FILETIME ftLastAccessTime;
  FILETIME ftLastWriteTime;
  DWORD    nFileSizeHigh;
  DWORD    nFileSizeLow;
  DWORD    dwReserved0;
  DWORD    dwReserved1;
  CHAR     cFileName[MAX_PATH];
  CHAR     cAlternateFileName[14];
  DWORD    dwFileType; // Obsolete. Do not use.
  DWORD    dwCreatorType; // Obsolete. Do not use
  WORD     wFinderFlags; // Obsolete. Do not use
} WIN32_FIND_DATAA, *PWIN32_FIND_DATAA, *LPWIN32_FIND_DATAA;

Члены

dwFileAttributes

Атрибуты файла.

Возможные значения и их описания см. в разделе Константы атрибутов файлов.

Атрибут FILE_ATTRIBUTE_SPARSE_FILE в файле устанавливается, если какой-либо из потоков файла когда-либо был разрежен.

ftCreationTime

Структура FILETIME , указывающая время создания файла или каталога.

Если базовая файловая система не поддерживает время создания, этот элемент равен нулю.

ftLastAccessTime

Структура FILETIME .

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

Для каталога структура определяет время создания каталога. Если базовая файловая система не поддерживает время последнего доступа, этот элемент равен нулю.

В файловой системе FAT указанная дата для файлов и каталогов является правильной, но время суток всегда равно полуночи.

ftLastWriteTime

Структура FILETIME .

Для файла структура определяет время последней записи, усечения или перезаписи файла, например при использовании WriteFile или SetEndOfFile . Дата и время не обновляются при изменении атрибутов файлов или дескрипторов безопасности.

Для каталога структура определяет время создания каталога. Если базовая файловая система не поддерживает время последней записи, этот элемент равен нулю.

nFileSizeHigh

Значение DWORD высокого порядка размера файла в байтах.

Это значение равно нулю, если размер файла не превышает ЗНАЧЕНИЕ MAXDWORD.

Размер файла равен (nFileSizeHigh * (MAXDWORD+1)) + nFileSizeLow.

nFileSizeLow

Значение DWORD низкого порядка размера файла в байтах.

dwReserved0

Если элемент dwFileAttributes содержит атрибут FILE_ATTRIBUTE_REPARSE_POINT , этот элемент задает тег точки повторного измерения.

В противном случае это значение не определено и не должно использоваться.

Дополнительные сведения см. в разделе Повторная аналитика тегов точек.

IO_REPARSE_TAG_CSV (0x80000009)

IO_REPARSE_TAG_DEDUP (0x80000013)

IO_REPARSE_TAG_DFS (0x8000000A)

IO_REPARSE_TAG_DFSR (0x80000012)

IO_REPARSE_TAG_HSM (0xC0000004)

IO_REPARSE_TAG_HSM2 (0x80000006)

IO_REPARSE_TAG_MOUNT_POINT (0xA0000003)

IO_REPARSE_TAG_NFS (0x80000014)

IO_REPARSE_TAG_SIS (0x80000007)

IO_REPARSE_TAG_SYMLINK (0xA000000C)

IO_REPARSE_TAG_WIM (0x80000008)

dwReserved1

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

cFileName[MAX_PATH]

Имя файла.

cAlternateFileName[14]

Альтернативное имя файла.

Это имя в классическом формате имени файла 8.3.

Если файл имеет длинное имя файла, полное имя отображается в элементе cFileName , а усеченная версия имени формата 8.3 отображается в элементе cAlternateFileName . В противном случае параметр cAlternateFileName пуст. Если функция FindFirstFileEx была вызвана со значением FindExInfoBasic в параметре fInfoLevelId , элемент cAlternateFileName всегда будет содержать строковое значение NULL . Это остается верным для всех последующих вызовов функции FindNextFile . В качестве альтернативного метода получения имени файла в формате 8.3 можно использовать функцию GetShortPathName . Дополнительные сведения об именах файлов см. в разделе Имена файлов, пути и пространства имен.

Не все файловые системы могут записывать время создания и последнего доступа, и не все файловые системы записывают их одинаково. Например, в файловой системе FAT время создания имеет разрешение 10 миллисекунд, время записи — 2 секунды, а время доступа — 1 день. Файловая система NTFS задерживает обновления до времени последнего доступа к файлу на срок до 1 часа после последнего доступа. Дополнительные сведения см. в разделе Время файла.

Примечание

Заголовок minwinbase.h определяет WIN32_FIND_DATA в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Верхняя часть	minwinbase.h (включая Windows.h)