Función SetLocalTime (sysinfoapi.h)
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 |