Condividi tramite


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