Función SetSystemTime

Asigna la fecha y hora de sistema actual. La hora de sistema se expresa en tiempo coordinado universal (UTC).

Sintaxis

BOOL SetSystemTime(
    const SYSTEMTIME *lpSystemTime
);

Parámetros

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

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 SetSystemTime habilita el privilegio SE_SYSTEMTIME_NAME antes de cambiar la hora local y lo desactiva antes de retornar.