Funzione SystemTimeToFileTime (timezoneapi.h)

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

Vedere anche

DosDateTimeToFileTime

FILETIME

FileTimeToDosDateTime

FileTimeToSystemTime

SYSTEMTIME

Ora di sistema

Funzioni temporali