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

Статья
03/13/2024

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

Синтаксис

typedef struct _WIN32_FIND_DATAW {
  DWORD    dwFileAttributes;
  FILETIME ftCreationTime;
  FILETIME ftLastAccessTime;
  FILETIME ftLastWriteTime;
  DWORD    nFileSizeHigh;
  DWORD    nFileSizeLow;
  DWORD    dwReserved0;
  DWORD    dwReserved1;
  WCHAR    cFileName[MAX_PATH];
  WCHAR    cAlternateFileName[14];
  DWORD    dwFileType; // Obsolete. Do not use.
  DWORD    dwCreatorType; // Obsolete. Do not use
  WORD     wFinderFlags; // Obsolete. Do not use
} WIN32_FIND_DATAW, *PWIN32_FIND_DATAW, *LPWIN32_FIND_DATAW;

Члены

dwFileAttributes

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

Возможные значения и их описания см. в разделе File Attribute Constants.

Атрибут 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 час после последнего доступа. Дополнительные сведения см. в разделе File Times.

Примечание

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

Требования

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