TzSpecificLocalTimeToSystemTime-Funktion (timezoneapi.h)

Artikel
08/26/2023

Konvertiert eine Ortszeit in eine Zeit in koordinierte Weltzeit (UTC).

Syntax

BOOL TzSpecificLocalTimeToSystemTime(
  [in, optional] const TIME_ZONE_INFORMATION *lpTimeZoneInformation,
  [in]           const SYSTEMTIME            *lpLocalTime,
  [out]          LPSYSTEMTIME                lpUniversalTime
);

Parameter

[in, optional] lpTimeZoneInformation

Ein Zeiger auf eine TIME_ZONE_INFORMATION-Struktur , die die Zeitzone für die in lpLocalTime angegebene Zeit angibt.

Wenn lpTimeZoneInformationNULL ist, verwendet die Funktion die derzeit aktive Zeitzone.

[in] lpLocalTime

Ein Zeiger auf eine SYSTEMTIME-Struktur , die die zu konvertierende Ortszeit angibt. Die Funktion konvertiert dieses Mal in die entsprechende UTC-Zeit.

[out] lpUniversalTime

Ein Zeiger auf eine SYSTEMTIME-Struktur , die die UTC-Zeit empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich null, und die Funktion legt die Member der SYSTEMTIME-Struktur , auf die von lpUniversalTime verwiesen wird, auf die entsprechenden Werte fest.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

TzSpecificLocalTimeToSystemTime berücksichtigt, ob die Sommerzeit (DST) für die umzurechnende Ortszeit wirksam ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	timezoneapi.h (Einschließen von Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll