GetFileTime
The GetFileTime
function retrieves the date and time that a file was created, last accessed,
and last modified.
BOOL GetFileTime(
|
HANDLE hFile, |
// identifies the
file |
|
LPFILETIME lpCreationTime, |
// address of
creation time |
|
LPFILETIME lpLastAccessTime, |
// address of last
access time |
|
LPFILETIME lpLastWriteTime |
// address of last
write time |
|
); |
|
Parameters
hFile
Identifies
the files for which to get dates and times. The file handle must have been
created with GENERIC_READ access to the file.
lpCreationTime
Points to a FILETIME structure to receive the
date and time the file was created. This parameter can be NULL if the
application does not require this information.
lpLastAccessTime
Points to a FILETIME
structure to receive the date and time the file was last accessed. The last
access time includes the last time the file was written to, read from, or, in
the case of executable files, run. This parameter can be NULL if the
application does not require this information.
lpLastWriteTime
Points to a FILETIME structure to receive the
date and time the file was last written to. This parameter can be NULL if the
application does not require this information.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
Remarks
The FAT and
New Technology file systems support the file creation, last access, and last
write time values.
Windows
95: The precision of the time for a
file in a FAT file system is 2 seconds. The time precision for files in other
file systems, such as those connected through a network depends on the file
system but may also be limited by the remote device.
See Also