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.

 ◄Summary► ◄Example►                         ◄Up► ◄Contents► ◄Index► ◄Back►
─────Run-Time Library───────────────────────────────────────────────────────
 
     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 with DOS. 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.
                                    -♦-