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 |