sysinfoapi.h

SetLocalTime function

Asigna la fecha y hora local actual.

Sintaxis

BOOL SetLocalTime(
    const SYSTEMTIME *lpSystemTime
);

Parámetros

lpSystemTime: Un puntero a una estructura SYSTEMTIME que contiene la nueva fecha y hora local.

El miembro wDayOfWeek de la estructura es ignorado.

Valor de retorno

Si la función tiene éxito, el valor de retorno es distinto de cero.

Si la función falla, el valor de retorno es cero. Para obtener información adicional sobre el error, llamar a la función GetLastError.

Observaciones

El proceso que llama debe tener el privilegio SE_SYSTEMTIME_NAME. Este privilegio está desactivado por defecto. La función SetLocalTime habilita el privilegio SE_SYSTEMTIME_NAME antes de cambiar la hora local y lo desactiva antes de retornar.

El sistema usa UTC internamente. Por lo tanto, cuando se llama a SetLocalTime, el sistema usa la información de la zona horaria actual para realizar la conversión, incluyendo la configuración del horario de verano. Hay que tener en cuenta que el sistema utiliza la configuración de horario de verano de la hora actual, no la de la nueva hora que se está asignando. Por lo tanto, para garantizar que el resultado es correcto, se debe llamar a la función SetLocalTime una segunda vez, ahora que la primera llamada ha actualizado la configuración del horario de verando.