Función SetLocalTime (sysinfoapi.h)

Artículo
03/05/2024

Establece la hora y la fecha locales actuales.

Sintaxis

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

Parámetros

[in] lpSystemTime

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

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 SetLocalTime habilita el privilegio SE_SYSTEMTIME_NAME antes de cambiar la hora local y deshabilita el privilegio antes de devolverlo. Para más información, consulte Ejecución con privilegios especiales.

El sistema usa utc internamente. Por lo tanto, cuando se llama a SetLocalTime, el sistema usa la información de zona horaria actual para realizar la conversión, incluida la configuración del horario de verano. Tenga en cuenta que el sistema usa la configuración del horario de verano de la hora actual, no la nueva hora que está estableciendo. Por lo tanto, para asegurarse del resultado correcto, llame a SetLocalTime una segunda vez, ahora que la primera llamada ha actualizado la configuración del horario de verano.

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