SetSystemTime-Funktion (sysinfoapi.h)
Legt die aktuelle Systemzeit und das aktuelle Systemdatum fest. Die Systemzeit wird in koordinierter Weltzeit (UTC) ausgedrückt.
Syntax
BOOL SetSystemTime(
[in] const SYSTEMTIME *lpSystemTime
);
Parameter
[in] lpSystemTime
Ein Zeiger auf eine SYSTEMTIME-Struktur , die das neue Systemdatum und die neue Systemzeit 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 SetSystemTime-Funktion aktiviert das SE_SYSTEMTIME_NAME-Recht vor dem Ändern der Systemzeit und deaktiviert die Berechtigung vor der Rückgabe. Weitere Informationen finden Sie unter Ausführen mit speziellen Berechtigungen.
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 |