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

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 (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll

Vea también

GetSystemTime

SYSTEMTIME

SetSystemTimeAdjustment

Hora del sistema

Funciones de hora