SystemTimeToFileTime-Funktion (timezoneapi.h)

Artikel
03/02/2024

Konvertiert eine Systemzeit in das Dateizeitformat. Die Systemzeit basiert auf koordinierter Weltzeit (UTC).

Syntax

BOOL SystemTimeToFileTime(
  [in]  const SYSTEMTIME *lpSystemTime,
  [out] LPFILETIME       lpFileTime
);

Parameter

[in] lpSystemTime

Ein Zeiger auf eine SYSTEMTIME-Struktur , die die Systemzeit enthält, die von UTC in das Dateiformat konvertiert werden soll.

Das wDayOfWeek-Element der SYSTEMTIME-Struktur wird ignoriert.

[out] lpFileTime

Ein Zeiger auf eine FILETIME-Struktur , um die konvertierte Systemzeit zu empfangen.

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.

Hinweis

Ein False-Rückgabewert kann angeben, dass die übergebene SYSTEMTIME-Struktur ein ungültiges Datum darstellt. Bestimmte Situationen, z. B. der zusätzliche Tag, der in einem Schaltjahr hinzugefügt wurde, können dazu führen, dass die Anwendungslogik unerwartet ein ungültiges Datum erstellt. Weitere Informationen zum Vermeiden dieser Probleme finden Sie unter Bereitschaft zum Schaltjahr.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	timezoneapi.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll