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

Статья
11/20/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, а в элемент cAlternateFileName отображается формат 8.3. В противном случае 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)