Important Notice
The pages on this site contain documentation for very old MS-DOS software,
purely for historical purposes.
If you're looking for up-to-date documentation, particularly for programming,
you should not rely on the information found here, as it will be woefully
out of date.
utime
◄Summary► ◄Example► ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
The utime function sets the modification time for the file
specified by <filename>. The process must have write access to the
file; otherwise, the time cannot be changed.
Although the utimbuf structure contains a field for access time,
only the modification time is set under DOS and OS/2. If <times>
is a NULL pointer, the modification time is set to the current
time. Otherwise, <times> must point to a structure of type
utimbuf (defined in SYS\UTIME.H). The modification time is set
from the modtime field in this structure.
Return Value
The utime function returns the value 0 if the file-modification
time was changed. A return value of -1 indicates an error, and
errno is set to EACCES, EINVAL, EMFILE, or ENOENT.
-♦-