Condividi tramite


Funzione SetLocalTime (sysinfoapi.h)

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

Vedere anche

GetLocalTime

GetSystemTime

Ora locale

SYSTEMTIME

SetSystemTimeAdjustment

Funzioni temporali