SetLocalTime-Funktion (sysinfoapi.h)

Legt die aktuelle Ortszeit und das aktuelle Datum fest.

Syntax

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

Parameter

[in] lpSystemTime

Ein Zeiger auf eine SYSTEMTIME-Struktur , die das neue lokale Datum und die neue lokale Uhrzeit enthält.

Das wDayOfWeek-Element der SYSTEMTIME-Struktur wird ignoriert.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Der aufrufende Prozess muss über die berechtigung SE_SYSTEMTIME_NAME verfügen. Diese Berechtigung ist standardmäßig deaktiviert. Die SetLocalTime-Funktion aktiviert die SE_SYSTEMTIME_NAME-Berechtigung vor dem Ändern der Ortszeit und deaktiviert die Berechtigung vor der Rückgabe. Weitere Informationen finden Sie unter Ausführen mit speziellen Berechtigungen.

Das System verwendet UTC intern. Wenn Sie SetLocalTime aufrufen, verwendet das System daher die aktuellen Zeitzoneninformationen, um die Konvertierung durchzuführen, einschließlich der Sommerzeiteinstellung. Beachten Sie, dass das System die Sommerzeiteinstellung der aktuellen Zeit verwendet, nicht die neue Zeit, die Sie festlegen. Um das richtige Ergebnis sicherzustellen, rufen Sie setLocalTime daher ein zweites Mal auf, nachdem die Sommerzeiteinstellung beim ersten Aufruf aktualisiert wurde.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile sysinfoapi.h (einschließlich Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

GetLocalTime

GetSystemTime

Ortszeit

SYSTEMTIME

SetSystemTimeAdjustment

Zeitfunktionen