Funzione SystemTimeToFileTime (timezoneapi.h)

Articolo
03/05/2024

Converte un'ora di sistema in formato ora file. L'ora di sistema è basata sull'ora UTC (Coordinated Universal Time).

Sintassi

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

Parametri

[in] lpSystemTime

Puntatore a una struttura SYSTEMTIME che contiene l'ora di sistema da convertire dall'ora UTC al formato dell'ora file.

Il membro wDayOfWeek della struttura SYSTEMTIME viene ignorato.

[out] lpFileTime

Puntatore a una struttura FILETIME per ricevere l'ora di sistema convertita.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Nota

Un valore restituito False può indicare che la struttura SYSTEMTIME passata rappresenta una data non valida. Alcune situazioni, ad esempio il giorno aggiuntivo aggiunto in un anno bisestile, possono comportare la creazione imprevista della logica dell'applicazione di una data non valida. Per altre informazioni su come evitare questi problemi, vedere Preparazione dell'anno bisestile.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	timezoneapi.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll