FILETIME-Struktur (minwinbase.h)

Artikel
02/29/2024

Enthält einen 64-Bit-Wert, der die Anzahl der Intervalle von 100 Nanosekunden seit dem 1. Januar 1601 (UTC) darstellt.

Syntax

typedef struct _FILETIME {
  DWORD dwLowDateTime;
  DWORD dwHighDateTime;
} FILETIME, *PFILETIME, *LPFILETIME;

Member

dwLowDateTime

Der Teil der Dateizeit in niedriger Reihenfolge.

dwHighDateTime

Der Hohe Ordnungsanteil der Dateizeit.

Hinweise

Verwenden Sie die FileTimeToSystemTime-Funktion, um eine FILETIME-Struktur in eine Zeit zu konvertieren, die für einen Benutzer einfach angezeigt werden kann.

Es wird nicht empfohlen, Werte aus der FILETIME-Struktur hinzuzufügen und zu subtrahieren, um relative Zeiten zu erhalten. Stattdessen sollten Sie die Teile in niedriger und hoher Reihenfolge der Dateizeit in eine ULARGE_INTEGER-Struktur kopieren, 64-Bit-Arithmetik auf dem QuadPart-Member ausführen und die Elemente LowPart und HighPart in die FILETIME-Struktur kopieren.

Wandeln Sie keinen Zeiger auf eine FILETIME-Struktur in einen ULARGE_INTEGER*- oder __int64* -Wert um, da dies unter 64-Bit-Windows zu Ausrichtungsfehlern führen kann.

Nicht alle Dateisysteme können die Erstellung und den Zeitpunkt des letzten Zugriffs aufzeichnen, und nicht alle Dateisysteme erfassen sie auf die gleiche Weise. Beispielsweise hat die Erstellungszeit in NT FAT eine Auflösung von 10 Millisekunden, die Schreibzeit eine Auflösung von 2 Sekunden und die Zugriffszeit eine Auflösung von 1 Tag (eigentlich das Zugriffsdatum). Unter NTFS hat die Zugriffszeit eine Auflösung von 1 Stunde. Daher gibt die GetFileTime-Funktion möglicherweise nicht die gleichen Dateizeitinformationen zurück, die mithilfe der SetFileTime-Funktion festgelegt wurden. Darüber hinaus zeichnet FAT die Uhrzeiten auf dem Datenträger in Ortszeit auf. NTFS zeichnet jedoch Zeiten auf dem Datenträger in UTC auf. Weitere Informationen finden Sie unter Dateizeiten.

Eine Funktion, die die FILETIME-Struktur verwendet, kann Werte außerhalb von Null- oder positiven Werten zulassen, die in der Regel durch die Elemente dwLowDateTime und dwHighDateTime angegeben werden. Die SetFileTime-Funktion verwendet beispielsweise 0xFFFFFFFF, um anzugeben, dass die vorherige Zugriffszeit einer Datei beibehalten werden soll. Weitere Informationen finden Sie im Thema für die Funktion, die Sie aufrufen.

Beispiele

Ein Beispiel finden Sie unter Ändern einer Dateizeit in die aktuelle Zeit oder Abrufen der Last-Write Zeit.

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]
Kopfzeile	minwinbase.h (windows.h einschließen)

Weitere Informationen