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 |