GetFileTime

Функция GetFileTime извлекает дату и время файла, когда он был создан, когда к нему последний раз обращались, и когда он последний раз был изменен.

BOOL GetFileTime (

    HANDLE hFile , // идентифицирует файл
    LPFILETIME lpCreationTime , // адрес времени создания файла
    LPFILETIME lpLastAccessTime , // адрес времени последнего доступа

// к файлу

    LPFILETIME lpLastWriteTime  // адрес времени последней записи в файл
   );

Параметры

hFile - идентифицирует файл, для которого извлекаются дата и время. Файловый дескриптор должен быть создан с доступом GENERIC_READ к файлу.
lpCreationTime - указывает на структуру типа FILETIME , которая получает дату и время создания файла. Значение этого параметра может быть равно NULL , если приложению не требуется эта информация.
lpLastAccessTime - указывает на структуру типа FILETIME , которая получает дату и время последнего доступа к файлу. Время последнего доступа включает в себя время, когда в последний раз: в файл записывалась информация, читалась информация из файла, или, в случае исполняемых файлов, файл запускался на исполнение. Значение этого параметра может быть равно NULL , если приложению не требуется эта информация.
lpLastWriteTime - указывает на структуру типа FILETIME , которая получает дату и время последней записи в файл. Значение этого параметра может быть равно NULL , если приложению не требуется эта информация.

Возвращаемые значения

В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .

Комментарии

Файловые системы FAT и NTFS поддерживают время создания файла, время последнего доступа к файлу и время последней записи в файл.
Windows 95: Точность значения времени для файла в файловой системе FAT - 2 секунды. Точность значения времени для файлов в других файловых системах, например, на сетевых дисках, зависит от файловой системы, но также может быть ограничена удаленным устройством.

См. также

FILETIME , GetFileSize , GetFileType , SetFileTime .