SetDynamicTimeZoneInformation-Funktion (timezoneapi.h)

Legt die einstellungen für die aktuelle Zeitzone und die dynamische Sommerzeit fest. Diese Einstellungen steuern Übersetzungen von koordinierter Weltzeit (UTC) zu Ortszeit.

Syntax

BOOL SetDynamicTimeZoneInformation(
  [in] const DYNAMIC_TIME_ZONE_INFORMATION *lpTimeZoneInformation
);

Parameter

[in] lpTimeZoneInformation

Ein Zeiger auf eine DYNAMIC_TIME_ZONE_INFORMATION-Struktur .

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

Eine Anwendung muss über die berechtigung SE_TIME_ZONE_NAME verfügen, damit diese Funktion erfolgreich ist. Diese Berechtigung ist standardmäßig deaktiviert. Verwenden Sie die Funktion AdjustTokenPrivileges , um die Berechtigung vor dem Aufruf von SetDynamicTimeZoneInformation zu aktivieren, und deaktivieren Sie dann die Berechtigung nach dem SetDynamicTimeZoneInformation-Aufruf . Weitere Informationen finden Sie unter Ausführen mit speziellen Berechtigungen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	timezoneapi.h (Einschließen von Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

DYNAMIC_TIME_ZONE_INFORMATION

GetDynamicTimeZoneInformation

Zeitfunktionen