Funzione SetSystemTime (sysinfoapi.h)

Imposta l'ora e la data di sistema correnti. L'ora del sistema è espressa in Utc (Coordinated Universal Time).

Sintassi

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

Parametri

[in] lpSystemTime

Puntatore a una struttura SYSTEMTIME contenente la nuova data e l'ora del sistema.

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 di chiamata deve avere il privilegio di SE_SYSTEMTIME_NAME. Questo privilegio è disabilitato per impostazione predefinita. La funzione SetSystemTime abilita il privilegio SE_SYSTEMTIME_NAME prima di modificare l'ora di sistema e disabilita il privilegio prima di restituire. Per altre informazioni, vedere Esecuzione con privilegi speciali.

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 (includere Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

GetSystemTime

SYSTEMTIME

SetSystemTimeAdjustment

Ora di sistema

Funzioni temporali