Función GetSystemTimeAdjustment (sysinfoapi.h)

Artículo
03/02/2024

Determina si el sistema está aplicando ajustes periódicos de hora a su reloj de hora del día y obtiene el valor y el período de cualquier ajuste de este tipo.

Sintaxis

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

Parámetros

[out] lpTimeAdjustment

Puntero a una variable que la función establece en el número de unidades lpTimeIncrement de 100 nanosegundos agregadas al reloj de hora del día durante cada período de tiempo que realmente pasa según lo contado por el sistema. Este valor solo tiene significado si lpTimeAdjustmentDisabled es FALSE.

[out] lpTimeIncrement

Puntero a una variable que la función establece en el intervalo en unidades de 100 nanosegundos en las que el sistema agregará lpTimeAdjustment al reloj de hora del día. Este valor solo tiene significado si lpTimeAdjustmentDisabled es FALSE.

[out] lpTimeAdjustmentDisabled

Puntero a una variable que la función establece para indicar si el ajuste de hora periódico está en vigor.

Un valor true indica que el ajuste periódico de la hora está deshabilitado y el reloj de hora del sistema avanza a la velocidad normal. En este modo, el sistema puede ajustar la hora del día mediante sus propios mecanismos de sincronización de hora interna. Estos mecanismos internos de sincronización de hora pueden provocar que el reloj de hora del día cambie durante el curso normal de la operación del sistema, lo que puede incluir saltos notables en el tiempo según lo considere necesario por el sistema.

Un valor false indica que se usa el ajuste periódico de la hora para ajustar el reloj de hora del día. Para cada período de tiempo lpTimeIncrement que pase realmente, lpTimeAdjustment se agregará a la hora del día. Si el valor lpTimeAdjustment es menor que lpTimeIncrement, el reloj de hora del día del sistema avanzará a una velocidad más lenta que la normal. Si el valor lpTimeAdjustment es mayor que lpTimeIncrement, el reloj de hora del día avanzará a una velocidad más rápida de lo normal. Si lpTimeAdjustment es igual a lpTimeIncrement, el reloj de hora del día avanzará a su velocidad normal. El valor lpTimeAdjustment se puede establecer llamando a SetSystemTimeAdjustment. El valor lpTimeIncrement es fijo por el sistema al iniciarse y no cambia durante la operación del sistema. En este modo, el sistema no interferirá con el esquema de ajuste de tiempo y no intentará sincronizar la hora del día por sí misma a través de otras técnicas.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Las funciones GetSystemTimeAdjustment y SetSystemTimeAdjustment se pueden usar para admitir algoritmos que quieran sincronizar el reloj de hora del día, notificado por GetSystemTime y GetLocalTime, con otro origen de hora mediante un ajuste periódico de la hora.

La función GetSystemTimeAdjustment permite a un autor de la llamada determinar si se habilita el ajuste de tiempo periódico y, si es así, obtener la cantidad de cada ajuste y el tiempo entre los ajustes. La función SetSystemTimeAdjustment permite que un autor de la llamada habilite o deshabilite el ajuste periódico y establezca el valor del incremento de ajuste.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	sysinfoapi.h (incluye Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll