Freigeben über


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

Siehe auch

GetSystemTime

SYSTEMTIME

SetSystemTimeAdjustment

Systemzeit

Zeitfunktionen