SystemTimeToFileTime-Funktion (timezoneapi.h)
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 |