Función SetSystemTime (sysinfoapi.h)

Establece la fecha y la hora actuales del sistema. La hora del sistema se expresa en hora universal coordinada (UTC).

Sintaxis

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

Parámetros

[in] lpSystemTime

Puntero a una estructura SYSTEMTIME que contiene la nueva fecha y hora del sistema.

Se omite el miembro wDayOfWeek de la estructura SYSTEMTIME .

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

El proceso de llamada debe tener el privilegio SE_SYSTEMTIME_NAME. Este privilegio está deshabilitado de forma predeterminada. La función SetSystemTime habilita el privilegio SE_SYSTEMTIME_NAME antes de cambiar la hora del sistema y deshabilita el privilegio antes de devolverlo. Para más información, consulte Ejecución con privilegios especiales.

Requisitos

Vea también

GetSystemTime

SYSTEMTIME

SetSystemTimeAdjustment

Hora del sistema

Funciones de hora