FileSetDate

Set the date of a file.

Declaration

Source position: filutilh.inc line 184

  function FileSetDate(const FileName: UnicodeString; Age: Int64)
                       : LongInt;
  function FileSetDate(const FileName: RawByteString; Age: Int64)
                       : LongInt;
  function FileSetDate(Handle: THandle; Age: Int64) : LongInt;

Description

FileSetDate sets the file date of the open file with handle Handle or to Age, where Age is a DOS date-and-time stamp value.

Alternatively, the filename may be specified with the FileName argument. This variant of the call is mandatory on Unixes, since there is no OS support for setting a file timestamp based on a handle. (the handle may not be a real file at all).

The function returns zero if successful.

Errors

On Unix, the handle variant always returns -1, since this is impossible to implement. On Windows and DOS, a negative error code is returned.