структура WIN32_FIND_DATAA (minwinbase.h)
Содержит сведения о файле, который найден функцией 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) |