int setftime(int handle, struct ftime *t)
Прототип:
Описание:
Эта функция не определена стандартом ANSI С.
Функция setftime() используется для установки даты и времени, ассоциированной с файлом на диске. Она изменяет дату и время файла, ассоциированного с параметром handle, используя информацию, хранящуюся в структуре, на которую указывает параметр t. Структура ftime определена следующим образом:
struct ftime { unsigned ft_tsec: 5; /* секунды */ unsigned ft_min: 6; /* минуты */ unsigned ft_hour: 5; /* часы */ unsigned ft_day: 5; /* дни */ unsigned ft_month: 4; /* месяцы */ unsigned ft_year: 7; /* годы с 198 0 */ };
Поскольку дата и время файла обычно используются для указания времени последней модификации, то необходимо использовать функцию setftime() достаточно осторожно.
При успешном вызове функции setftime() возвращается значение 0. При возникновении ошибки возвращается —1, а переменная errno принимает одно из следующих значений:
| Величина | Значение |
|---|---|
| EINVFNC | Неверный номер функции |
| EACCESS | Доступ запрещен |
| EBADF | Недействительный дескриптор файла |
Пример:
Следующая строка кода устанавливает время и дату файла, задаваемые структурой ftime: setftime(fd, &t);