Funzione SetLocalTime (sysinfoapi.h)

Articolo
03/08/2023

Imposta l'ora locale e la data correnti.

Sintassi

BOOL SetLocalTime(
  [in] const SYSTEMTIME *lpSystemTime
);

Parametri

[in] lpSystemTime

Puntatore a una struttura SYSTEMTIME che contiene la nuova data e l'ora locali.

Il membro wDayOfWeek della struttura SYSTEMTIME viene ignorato.

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.

Commenti

Il processo chiamante deve avere il privilegio SE_SYSTEMTIME_NAME. Questo privilegio è disabilitato per impostazione predefinita. La funzione SetLocalTime abilita il privilegio SE_SYSTEMTIME_NAME prima di modificare l'ora locale e disabilita il privilegio prima di restituire. Per altre informazioni, vedere Esecuzione con privilegi speciali.

Il sistema usa internamente l'ora UTC. Pertanto, quando si chiama SetLocalTime, il sistema usa le informazioni correnti sul fuso orario per eseguire la conversione, inclusa l'impostazione dell'ora legale. Si noti che il sistema usa l'impostazione dell'ora legale dell'ora corrente, non la nuova ora impostata. Pertanto, per garantire il risultato corretto, chiamare SetLocalTime una seconda volta, ora che la prima chiamata ha aggiornato l'impostazione dell'ora legale.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	sysinfoapi.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll