Funzione GetSystemTimeAdjustment (sysinfoapi.h)

Articolo
03/02/2024

Determina se il sistema applica le regolazioni temporali periodiche all'ora del giorno e ottiene il valore e il periodo di tali modifiche.

Sintassi

BOOL GetSystemTimeAdjustment(
  [out] PDWORD lpTimeAdjustment,
  [out] PDWORD lpTimeIncrement,
  [out] PBOOL  lpTimeAdjustmentDisabled
);

Parametri

[out] lpTimeAdjustment

Puntatore a una variabile che la funzione imposta sul numero di unità lpTimeIncrement 100-nanosecondo aggiunte all'ora del giorno per ogni periodo di tempo che effettivamente passa come conteggiato dal sistema. Questo valore ha significato solo se lpTimeAdjustmentDisabled è FALSE.

[out] lpTimeIncrement

Puntatore a una variabile che la funzione imposta sull'intervallo in unità a 100 nanosecondi in cui il sistema aggiungerà lpTimeAdjustment all'ora del giorno. Questo valore ha significato solo se lpTimeAdjustmentDisabled è FALSE.

[out] lpTimeAdjustmentDisabled

Puntatore a una variabile impostata dalla funzione per indicare se la regolazione temporale periodica è effettiva.

Un valore true indica che la regolazione temporale periodica è disabilitata e l'ora del sistema avanza al tasso normale. In questa modalità, il sistema può modificare l'ora del giorno usando i propri meccanismi di sincronizzazione temporale interna. Questi meccanismi di sincronizzazione dell'ora interna possono causare la modifica dell'ora del giorno durante il normale corso dell'operazione di sistema, che può includere i salti evidenti nel tempo, come considerato necessario dal sistema.

Un valore false indica che la regolazione temporale periodica viene usata per regolare l'ora del giorno. Per ogni periodo di tempo lpTimeIncrement che effettivamente passa, lpTimeAdjustment verrà aggiunto all'ora del giorno. Se il valore lpTimeAdjustment è minore di lpTimeIncrement, l'ora di sistema dell'orologio del giorno procederà in modo più lento rispetto al normale. Se il valore lpTimeAdjustment è maggiore di lpTimeIncrement, l'orologio di ora del giorno avanza a una velocità più veloce rispetto alla normale. Se lpTimeAdjustment è uguale a lpTimeIncrement, l'ora del giorno avanza alla sua velocità normale. Il valore lpTimeAdjustment può essere impostato chiamando SetSystemTimeAdjustment. Il valore lpTimeIncrement viene fisso dal sistema all'avvio e non cambia durante l'operazione di sistema. In questa modalità, il sistema non interferirà con lo schema di regolazione del tempo e non tenterà di sincronizzare l'ora del giorno in modo autonomo tramite altre tecniche.

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

Le funzioni GetSystemTimeAdjustment e SetSystemTimeAdjustment possono essere usate per supportare algoritmi che vogliono sincronizzare l'ora del giorno, segnalata da GetSystemTime e GetLocalTime, con un'altra origine temporale usando una regolazione temporale periodica.

La funzione GetSystemTimeAdjustment consente a un chiamante di determinare se la regolazione temporale periodica è abilitata e, se è, ottenere la quantità di ogni regolazione e il tempo tra le regolazioni. La funzione SetSystemTimeAdjustment consente a un chiamante di abilitare o disabilitare la regolazione temporale periodica e impostare il valore dell'incremento di regolazione.

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