Функция SystemTimeToFileTime (timezoneapi.h)

Статья
08/26/2023

Преобразует системное время в формат времени файла. Системное время основано на формате UTC.

Синтаксис

BOOL SystemTimeToFileTime(
  [in]  const SYSTEMTIME *lpSystemTime,
  [out] LPFILETIME       lpFileTime
);

Параметры

[in] lpSystemTime

Указатель на структуру SYSTEMTIME , содержащую системное время, которое необходимо преобразовать из формата UTC в формат времени файла.

Элемент wDayOfWeek структуры SYSTEMTIME игнорируется.

[out] lpFileTime

Указатель на структуру FILETIME для получения преобразованного системного времени.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Примечание

Возвращаемое значение False может указывать на то, что переданная структура SYSTEMTIME представляет недопустимую дату. Некоторые ситуации, например дополнительный день, добавленный в високосный год, могут привести к тому, что логика приложения неожиданно создает недопустимую дату. Дополнительные сведения о том, как избежать этих проблем, см. в разделе Готовность к високосным годам.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	timezoneapi.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll