GetFileTime-Funktion (fileapi.h)

Artikel
08/23/2023

Ruft das Datum und die Uhrzeit der Erstellung einer Datei oder eines Verzeichnisses, des letzten Zugriffs darauf und der letzten Änderung ab.

Syntax

BOOL GetFileTime(
  [in]            HANDLE     hFile,
  [out, optional] LPFILETIME lpCreationTime,
  [out, optional] LPFILETIME lpLastAccessTime,
  [out, optional] LPFILETIME lpLastWriteTime
);

Parameter

[in] hFile

Ein Handle für die Datei oder das Verzeichnis, für das Datums- und Uhrzeitangaben abgerufen werden sollen. Das Handle muss mithilfe der CreateFile-Funktion mit dem zugriffsrecht GENERIC_READ erstellt worden sein. Weitere Informationen finden Sie unter Dateisicherheit und Zugriffsrechte.

[out, optional] lpCreationTime

Ein Zeiger auf eine FILETIME-Struktur , um das Datum und die Uhrzeit der Erstellung der Datei oder des Verzeichnisses zu erhalten. Dieser Parameter kann NULL sein, wenn die Anwendung diese Informationen nicht benötigt.

[out, optional] lpLastAccessTime

Ein Zeiger auf eine FILETIME-Struktur , um das Datum und die Uhrzeit des letzten Zugriffs auf die Datei oder das Verzeichnis zu erhalten. Die letzte Zugriffszeit umfasst den Zeitpunkt, zu dem die Datei oder das Verzeichnis zuletzt geschrieben, gelesen oder im Fall ausführbarer Dateien ausgeführt wurde. Dieser Parameter kann NULL sein, wenn die Anwendung diese Informationen nicht benötigt.

[out, optional] lpLastWriteTime

Ein Zeiger auf eine FILETIME-Struktur zum Empfangen des Datums und der Uhrzeit, in die die Datei oder das Verzeichnis zuletzt geschrieben, abgeschnitten oder überschrieben wurde (z. B. mit WriteFile oder SetEndOfFile). Dieses Datum und die Uhrzeit werden nicht aktualisiert, wenn Dateiattribute oder Sicherheitsbeschreibungen geändert werden. Dieser Parameter kann NULL sein, wenn die Anwendung diese Informationen nicht benötigt.

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

Nicht alle Dateisysteme können erstellungs- und letzte Zugriffszeiten aufzeichnen, und nicht alle Dateisysteme erfassen diese auf die gleiche Weise. Beispielsweise hat die Erstellungszeit in 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). Daher gibt die GetFileTime-Funktion möglicherweise nicht die gleichen Dateizeitinformationen zurück, die mithilfe der SetFileTime-Funktion festgelegt wurden.

NTFS verzögert Aktualisierungen der letzten Zugriffszeit für eine Datei um bis zu einer Stunde nach dem letzten Zugriff. NTFS ermöglicht auch die Deaktivierung von Updates für die letzte Zugriffszeit. Die Uhrzeit des letzten Zugriffs wird auf NTFS-Volumes standardmäßig nicht aktualisiert.

Windows Server 2003 und Windows XP: Die Uhrzeit des letzten Zugriffs wird standardmäßig auf NTFS-Volumes aktualisiert.

Weitere Informationen finden Sie unter Dateizeiten.

Wenn Sie eine Datei umbenennen oder löschen, stellen Sie sie kurz danach wieder her, und Windows durchsucht den Cache nach dateiischen Informationen, die wiederhergestellt werden sollen. Zwischengespeicherte Informationen umfassen das Kurz-/Lange-Name-Paar und die Erstellungszeit.

Beispiele

Ein Beispiel finden Sie unter Abrufen der Last-Write Zeit.

Anforderungen


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