utime

Syntax

   #include <utime.h>  
    
   int utime  (  
      const char             *filename,   
      const struct utimbuf   *times);
   

Parameters

filename

(IN) Points to a string containing the name of the file whose modification time is to be updated (maximum 255 characters, including the NULL terminator).

times

(IN) Points to the structure containing the modification time.

Return values

Returns a value of 0 when the time was successfully recorded. A value of -1 indicates an error occurred. If an error occurs, errno is set.

Remarks

If the filename parameter specifies a directory, the modification time and date are updated and the last accessed date is ignored (since directories do not have a last accessed date).

If the times parameter is NULL, the current time is used for the update. Otherwise, the times parameter must point to an object of the struct utimbuf type.

The modification time is taken from the modtime field in the utimbuf structure, and the last accessed date is taken from the actime field. (DOS has no notion of "accessed time." Therefore when time is being set on the DOS partition, the value in the actime field is undefined, and only the modtime field is of concern.)

The current connection must have Modify rights or Write rights to update the last modification time. It must also have Modify or Read rights to update the last accessed date.

The SetCurrentNameSpace function sets the name space which is used for parsing the path input to utime.