Структура FILETIME (minwinbase.h)

Статья
08/24/2023

Содержит 64-разрядное значение, представляющее число 100-наносекундных интервалов с 1 января 1601 г. (UTC).

Синтаксис

typedef struct _FILETIME {
  DWORD dwLowDateTime;
  DWORD dwHighDateTime;
} FILETIME, *PFILETIME, *LPFILETIME;

Члены

dwLowDateTime

Часть времени файла в нижнем порядке.

dwHighDateTime

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

Не рекомендуется добавлять и вычитать значения из структуры FILETIME для получения относительного времени. Вместо этого следует скопировать части времени файла низкого и высокого порядка в ULARGE_INTEGER структуру, выполнить 64-разрядную арифметику для элемента QuadPart и скопировать элементы LowPart и HighPart в структуру FILETIME .

Не приведите указатель на структуру FILETIME к значению ULARGE_INTEGER* или __int64* , так как это может привести к сбоям выравнивания в 64-разрядной версии Windows.

Не все файловые системы могут записывать время создания и последнего доступа, и не все файловые системы записывают их одинаково. Например, в NT FAT время создания имеет разрешение 10 миллисекунд, время записи — 2 секунды, а время доступа — 1 день (фактически, дата доступа). В NTFS время доступа имеет разрешение 1 час. Таким образом, функция GetFileTime может не возвращать тот же набор сведений о времени файла с помощью функции SetFileTime . Кроме того, FAT записывает время на диске по местному времени. Однако NTFS записывает время на диске в формате UTC. Дополнительные сведения см. в разделе File Times.

Функция, использующий структуру FILETIME, может разрешать значения, не равные нулю или положительным значениям, обычно заданным элементами dwLowDateTime и dwHighDateTime . Например, функция SetFileTime использует 0xFFFFFFFF, чтобы указать, что необходимо сохранить предыдущее время доступа к файлу. Дополнительные сведения см. в разделе о вызываемой функции.

Примеры

Пример см. в разделе Изменение времени файла на текущее время или Получение времени Last-Write.

Требования

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

См. также раздел