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 |