Función SystemTimeToFileTime (timezoneapi.h)

Artículo
03/02/2024

Convierte una hora del sistema en formato de hora de archivo. La hora del sistema se basa en la hora universal coordinada (UTC).

Sintaxis

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

Parámetros

[in] lpSystemTime

Puntero a una estructura SYSTEMTIME que contiene la hora del sistema que se va a convertir de UTC a formato de hora de archivo.

Se omite el miembro wDayOfWeek de la estructura SYSTEMTIME .

[out] lpFileTime

Puntero a una estructura FILETIME para recibir la hora del sistema convertida.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Nota

Un valor devuelto False puede indicar que la estructura SYSTEMTIME pasada representa una fecha no válida. Algunas situaciones, como el día adicional agregado en un año bisiesto, pueden dar lugar a que la lógica de la aplicación cree inesperadamente una fecha no válida. Para obtener más información sobre cómo evitar estos problemas, consulte Preparación de año bisiesto.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	timezoneapi.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll